Skip to content

Editorial process description

Jump to bottom
Bryan Behrenshausen edited this page May 16, 2025 · 2 revisions

Explanation of editorial phases

1. To Assign

This material has been proposed but no author has committed to developing it.

2. Assigned

This material has been assigned to an author (or authors). These authors have not yet started composing it.

3. Drafting

This material is under construction. Authors are composing it.

4. Draft Ready

This material represents a complete draft ready for editorial review.

5. Development Edit

This material is undergoing potentially substantial edits. Editors are suggesting revisions to organization, flow, and argument. They may ask authors to add additional material.

6. Subject Matter Review

This material requires examination by a subject matter expert. Authors and editors are locating one, and that outside reader is assessing the material. Not all material requires this type of review.

7. Copy Edit

This material requires basic copy editing, which may include: standardizing voice and tone, eliminating grammatical issues, ensuring consistent punctuation, etc.

8. Technical Edit

This material requires markup and formatting for publication.

9. Final Review

Authors, editors, and anyone else working on the project is reviewing the material one final time.

10. Completed

Material is complete. Any proposed edits or additions should be submitted as new material and assigned an author.

Criteria for passing editorial phases

To enter Drafting

  • Authors have suggested an outline of proposed material
  • One or more editors have reviewed and and approved the authors' proposed outline

To enter Draft Ready

  • Drafted material adequately corresponds to proposed outline
  • Author has indicated that draft is ready for review by an editor

To enter Development Edit

  • Material submitted is a complete draft
  • Authors have submitted text in English
  • Authors have submitted all art and indicated proper attribution
  • Material passes a basic plagiarism check

To enter Subject Matter Review

  • Material is logically and coherently organized
  • Sidebars (if any) are appropriately formatted
  • Art (if any) is appropriately formatted
  • Material is stylistically consistent

To enter Copy Edit

  • Accuracy of subject matter has been confirmed
  • Authors have reviewed comments from subject matter experts and resolved all outstanding issues

To enter Technical Edit

  • Material has been edited for grammar and spelling
  • Authors have reviewed all proposed edits, have addressed outstanding questions from editors, and have approved all changes

To enter Final Review

  • Technical accuracy of materials has been confirmed
  • Material has been properly and completely typeset in Markdown
  • Authors and technical editors have completely resolved all outstanding issues and comments

To enter Completed

  • Material has been proofread one final time for spelling and grammatical errors
  • Editors have placed a reference to the new material in the SUMMARY.md table of contents file (if a new chapter)
  • Authors have acknowledged and/or approved all final changes

Clone this wiki locally