Linux Documentation Project Reviewer HOWTO

David Merrill

david -AT- lupercalia.net

Joy Yokley

2004-04-19

Revision History
Revision 1.4.22004-05-24EJH
Corrected spelling mistakes.
Revision 1.4.12004-04-19EJH
Minor updates to the language and markup, emphasizing the reporting procedures for reviews. Also changed the order of the reviews to reflect actual procedure (technical, language and finally metadata).
Revision 1.42004-04-18EJH
Updated the language review: clarified use of capitals, and added a new requirement that Latin abbreviations always use their English counterpart instead.
Revision 1.32004-01-31EJH
Added the metadata and markup review information.
Revision 1.22003-11-09TMM
Updated content, URLs, mailing lists, converted to XML.
Revision 1.12001-05-12DCM
Minor bugfixes.
Revision 1.02001-05-01jy
Initial release.

Abstract

This document will help you review LDP documentation. It includes procedures and techniques for the review process of all new, and existing, LDP documents.


Table of Contents

1. Introduction
1.1. Copyright and License
1.2. Acknowledgements
2. Reviewing Newly Submitted Documentation
3. Reviewing Existing Documentation
3.1. Choosing a Document
3.2. License Issues
3.3. Working With the Latest Version
3.4. Picking a Review to Conduct
4. Peer Review
5. Technical Accuracy Review
6. Language Review
7. Metadata and Markup Review
7.1. Required Markup
7.2. Required Metadata
8. Reporting Your Results
A. GNU Free Documentation License
1. 0. PREAMBLE
2. 1. APPLICABILITY AND DEFINITIONS
3. 2. VERBATIM COPYING
4. 3. COPYING IN QUANTITY
5. 4. MODIFICATIONS
6. 5. COMBINING DOCUMENTS
7. 6. COLLECTIONS OF DOCUMENTS
8. 7. AGGREGATION WITH INDEPENDENT WORKS
9. 8. TRANSLATION
10. 9. TERMINATION
11. 10. FUTURE REVISIONS OF THIS LICENSE
12. Addendum