OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

dita-adoption message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: Re: [dita-adoption] Summary of new OASIS process


Hi Kris,

  Two comments with regard to:
Once a Committee Note is approved and released, and it has graduated from "working draft" to "work product", is a revision or update of it considered a new Committee Note? I see nothing pertinent about revisions or versions of work products.

First, terminology. A Work Product is any deliverable at any stage of approval, including Committee Note Draft, Committee Note Public Review Draft, and Committee Note. A Working Draft is a deliverable that has not yet been voted and approved by the TC.

Second, process. A Committee Note can be re-approved any number of times; each subsequent change would be made to a Working Draft which would then be approved as a Committee Note Draft and submitted for a 15-day review. It's only when you reach OASIS Standard on the Standards Track that the cycle restarts.

Remember, all work of any TC is always publicly viewable; no work is ever hidden. A Public Review is just that, open to the public; not just the OASIS membership. Reviews can be announced on any list, and may even broaden participation by soliciting feedback from the intended audience.

Best regards,

Mary


On Nov 11, 2010, at 11:17 AM, Bruce Nevin (bnevin) wrote:

The policy bundling cosmetic issues together with substantive issues incurs at best some time delays but has the unfortunate effect of encouraging us to ignore comments that would merely improve readability or usability of the document.
 
Once a Committee Note is approved and released, and it has graduated from "working draft" to "work product", is a revision or update of it considered a new Committee Note? I see nothing pertinent about revisions or versions of work products.
 
Work products of the Adoption TC are responsive to more or less urgent needs. I can see the utility of TC members as individuals on their own writing less formal documents for distribution in a non-OASIS public venue. The exercise of developing such a document, and user experience with it, could inform a more deliberate process within the TC yielding a more formal work product. But the distinction would have to be clearly maintained.
 
    /B


From: Troy Klukewich [mailto:troy.klukewich@oracle.com] 
Sent: Thursday, November 11, 2010 9:06 AM
To: Kristen Eberlein; DITA Adoption TC
Subject: RE: [dita-adoption] Summary of new OASIS process

I think we’re going to have to carefully evaluate who are audience is and where they hang out. The process following seems well designed for official documents relating to and speaking to OASIS members, or for wider public distribution of documents officially representing the OASIS standards charter.
 
In terms of informal adoption documents, helping people get up to speed, as opposed to defining standards, I wonder if a public venue like dita.xml.org would be better, where anyone can join and contribute without a protracted review phase. I am very concerned that a protracted, complicated review phase with multiple votes and sign-offs is likely to curtail enthusiasm for writing helpful articles on a regular basis that are difficult enough to garner given our limited time and day jobs.

We could have a quicker, internal review as a “workgroup” within the Adoption TC, posting to dita.org. These would not be official standards documents representing the TC. Individual authorship could be noted.
 
We might have a triage for those documents that are official, which follow the TC process outlined following, and those that are not official, which are posted outside the auspices of the TC.
 
The downside I can see for unofficial documents is that they lose the “branding” of the Adoption TC, which I think is unfortunate, given that disseminating adoption information is the primary purpose of the TC (as opposed to coming up with standards). I do not know how to rectify branding, but perhaps this problem is better than curtailing article production.
 
Troy
 
From: Kristen Eberlein [mailto:keberlein@sdl.com] 
Sent: Wednesday, November 10, 2010 11:25 PM
To: DITA Adoption TC
Subject: [dita-adoption] Summary of new OASIS process
 
Key links:
 
OASIS Technical Committee Process: http://www.oasis-open.org/committees/process.php
 
 
Here is a summary of how the new OASIS processes will affect our feature articles
 
·         Our feature articles will need to follow the  guidelines outlined in “Section 2.1.8 Work Product Quality”:http://www.oasis-open.org/committees/process.php#specQuality . This means, among other items, that we need to provide editable source, XHTML (or HTML), and PDF.
·         Our feature articles (now called committee notes) must follow the processes outlined in “Section 3 Approval Process.”
http://www.oasis-open.org/committees/process.php#standApprovProcess

Here is my understanding of how the new process will affect our work:
o   We register the work product: http://marypmcrae.com/wptemplate-request
o   We approve the work product as a “Committee note draft.” This requires a full majority vote of the TC.
o   We decide to submit a committee note draft for public review; this also requires a full majority vote of the TC. If approved by the TC, this draft becomes a “Committee Note Public Review Draft”; it must be accompanied by a “recommendation from the TC of external stakeholders who should be notified of the review.”
o   We request a 30-day public review from Mary McRae: http://marypmcrae.com/30-day-cndpr-request. This request form requires the following information, among others:
§  URI for the committee note draft at http://docs.oasis-open.org/
§  Link to the minutes for the Adoption TC meeting at which the TC approved the committee note draft and voted to request a review
o   Mary McRae announces the public review to the OASIS membership list and “optionally on other public mail lists.”
o   Non-TC Members post comments to the TC's public-comment list. [Do we have such as list?] We must acknowledge the receipt of each comment and track the comments received; at the end of the review period, we need to post a list of how each comment has been handled to our e-mail list.
o   If we make ANY changes to the committee note draft as a result of the public review, we need to start the whole process over. The review period this time is only 15 days.
o   After a public review that does not generates any comments that result in the changes to the committee note draft, we can approve the work product as a committee note. This requires aspecial majority vote of the TC. If the 15-day review generated any comments, this vote cannot be held before seven days have passed since the close of the public review. To conduct the special majority vote, we need to notify Mary McRae that the TC is ready to vote and provide her with the location of the editable versions of the files. She sets up and conducts the ballot.
It’s not clear to me whether we’ll need to request that OASIS create and upload the committee note draft for us; there is a form for this at http://marypmcrae.com/cnd-creation-request .
Best regards,
Kris
Kristen James Eberlein l DITA Architect and Technical Specialist l SDL Structured Content Technologies Division l (t) + 1 (919) 682-2290 l keberlein@sdl.com
Please consider the environment before printing this e-mail
 



[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]