>> 6-Respond to a documentation change request: Review >> bugs that have the >> 'opensolaris' keyword and check to see if the >> submitter in field 6 answered Yes/No >> to the 'Submitter wants to work on bug' field. If >> not, proceed to address the change according to >> existing processes. If they answered Yes, contact a >> doc community leader to get started with working in >> the open. > > Again, a little awkward, I think. It remains a little unclear, though the > _gist_ of the text is fairly clear. (Does that make sense?)
True, a little convoluted. Instead of "If yes" / "If no" it might be sufficient just to keep the "if yes" part and throw out the "if no" part? >> 7-Communicate changes and contributions: Post changed >> documents to docs-discuss at opensolaris.org and cc: the >> bug submitter or contributor with a brief description >> of the change and under what heading it appears in >> the updated review copy. Feel free to also provide >> any addtional review details that might be >> appropriate. > > Except that you can't CC anyone/anything from the forum. You can only CC when > submitting from an email client (and since you can only have one email > address as yet, those of us contributing from home and work are stuck...). Excellent point. You may wish to raise this issue on website-discuss; I see no good reason why posting to the forum from the website shouldn't allow you to enter a CC: in some text box? > I also worry about the idea of posting a 30-page XML-based document to the > discussion forum. This would make for an enormous thread of one post. :-) > Perhaps it should involve posting _about_ the change(s), with some way of > putting the document on the site (the /tmp folder mentioned elsewhere? the > above-mentioned review page?) and a comment to that effect. Then, we would > need to move the updated document in place (over the old version) after the > review. But, are we overly complicating things, and who would do the work, > just which-ever leader gets to it first? Maybe this isn't as difficult as I'm > thinking right now. Thoughts? If contributors are using Sun/3s with 2400 baud modems, 30 pages of text might be a problem :) but I would hope folks would use common sense. Sending enormous PDFs to docs-discuss would not be very nice to do. XML source and diffs are the sorts of things which seem more appropriate for an email forum. - Eric
