Re: [bt-spec] BTP Issue 22 : Lack of accountability reflected fromD0.6 to D0.9

[William Cox <William.Cox@bea.com>]

The original issue is at the end of this email.

I will be satisfied if a "revision history" (non-normative appendix)
were maintained in the draft, mentioning significant changes from the
respective previous drafts. The issue said "Alistair and Peter's email
is a start;" taking that start and including the steps to current draft
is fine.

Some of the changes will need detailed rationale in the draft explaining
the choices and reasoning behind selecting the alternative used (and
yes, this draft still needs rationale in-line). The point of the
original Issue 22 was that the thought processes and evolution and
consensus behind that evolution was not visible at all in the document.
That concern still holds (pending the re-insertion of rationale and
other explanatory material).

This could be instantiated as a simpler, new issue (depending on Peter's
preference) and the original satisfied, or we could update the present
issue 22 with a new title.

bill cox


Category: editorial
Submitter: Bill Cox, (for all BEA members)
Submitter's identification: issue A. This issue was marked as
"procedural and editorial" by the submitter
Problem:
The transitions from D0.6 to D0.9 (including the "not distributed"
drafts 0.7, 0.72, and 0.8) were not
clearly based in decisions of the working group. Instead, to all
appearances, the document changed
rapidly and without consultation. If we take the time series from Draft
0.6 to date, it looks like we
should be at draft 1.5 in a few more weeks.
Proposed Remedy:
Enumerate the changes (Alistair and Peter's email is a start), then
discuss and vote on each in turn.
Include rationale, or contemporaneous minutes, supporting the decisions
made.
begin:vcard 
n:Cox;William
tel;cell:+1 908 385 7855
tel;fax:+1 908 580 3060
tel;work:+1 908 580 3458
x-mozilla-html:FALSE
url:http://www.bea.com/
org:BEA Systems, Inc.;Architecture and Standards
adr:;;140 Allen Rd;Liberty Corner;NJ;07938;USA
version:2.1
email;internet:William.Cox@bea.com
title:Technical Director
fn:William Cox
end:vcard