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: White paper process


I feel that it would be useful to establish a process for creating white papers. This would provide guidance for those who have not written white papers for the Adoption TC, and it would serve as a checklist for those who have.

Here is a strawman proposal for a process:

  1. Identify a need. This need should determine scope.

  2. Find an author

  3. Identify subject matter experts. The Adoption TC should participate in this. 

  4. Write the content. This phase may involve interaction with subject matter experts.

  5. Produce a draft

    1. One week prior to draft, send a request for reviewers to the DITA Adoption list and the DITA TC list

    2. Put together a list of reviewers. This list should include all who responded to the request for reviewers plus all subject matter experts.

    3. The list of reviewers shall be included in the draft next to the revision change history

    4. Invite reviewers to identify others who ought to review the draft emphasizing that such feedback should go the author immediately

  6. Incorporate comments. Authors are strongly encouraged to let reviewers know the rationale when they opt not to accept a significant comment.

  7. Produce a preliminary. The distribution of this preliminary should include the DITA Adoption list. If extensive comments were incorporated from other reviewers, then the preliminary should be distributed to all of the reviewers.

  8. Vote to publish

  9. Publish the final

Best Regards,
--
Bob Thomas
+1 720 201 8260
Skype: bob.thomas.colorado
Instant messaging: Gmail chat (bob.thomas@tagsmiths.com) or Skype
Time zone: Mountain (GMT-7)




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