[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
stds-802-16-tg2: thoughts on comment resolution process
Here are a few things I learned in the comment resolution process:
*Spreadsheets don't work really well as databases or word processors,
but they suffice.
*The clause editors needs to be given a list of Recommendations to
select from. The list that Muya and I came up with works pretty well:
Accepted accepted verbatim
Accepted-Modified the recommendation addresses the intent of the comment
Accepted-Clarified an implementation of what the comment wanted
Accepted-Duplicate the comment is OK but was handled in another comment
Superceded comment not usable due to acceptance of another comment
We can include these choices on the spreadsheet as form elements.
*If a comment is just plain "Accepted", the resolution should not
repeat the comment. Otherwise, the reader has to study the comment
and the resolution word by word to see that there is no difference.
*The clause editors need to distinguish carefully between what goes
in the Proposed Resolution column (which should be specific) and what
is the Reason.
*Neither the Proposed Resolution section nor the Reason section needs
to say things like:
-I think this is good idea.
-I don't like this idea.
-I suggest we accept this one.
The best way to handle these kind of notes is to add a field labeled
"Clause Editor's comments." These comments will be useful by the
Comment Resolution Committee but will not be entered into the
database or reported.
*We need a Notes field, especially to note ramifications that we
don't want to forget about.
*The clause editors did a good job of getting their suggestions in. Thanks!
*The resolutions require careful review by an editor for editorial
corrections, oversights, ambiguities, and consistency with the rest
of the text and among the various resolutions. I spent a lot of time
on this, and Muya did a great job. Now that Muya is fully on board, I
think he will be able to handle the editorial work alone, especially
if we sharpen the clause editors' input format.
*The clause editors did a nice job of communicating with the negative
voters to make sure the resolution would address their concerns. We
still need to reconfirm and get those Approve ballots turned in.