Content Development Planning

This page lists subjects in search of a writer and a dashboard of writing in progress. If you have interest in developing a document about one of these subjects or some subject that interests you, please send your contact information and a description of your interest to our authoring committee at [email protected].

We will get right back to you.

See our no-frills editorial style guide for authoring guidelines.

See our working description of roles for content reviewers.

Work in progress

dashboard

Subjects not yet claimed or started

Conceptuals

  • What is copyediting?
  • How do I learn about becoming a copyeditor?
  • What is a component content management system (CCMS)?
  • How does a CCMS differ from a CMS (content management system)?
  • What does a technical editor do?
  • What does a technical archivist do?
  • What is DITA inheritance?
  • How is web information architecture different from content architecture?
  • What are the different types of metadata relevant to authoring and publishing?
  • What is the difference between well-formed and valid markup?
  • How far can I go in MS Word to implement structured authoring?
  • What is Schematron and how do writing teams use it?
  • What is AsciiDoc?
  • What is GitHub Flavored Markdown?
  • What is Vale and how can it evaluate structured content?
  • What are the most common roles on a tech writing team?
  • How do I collect information from technical experts?
  • What are stages in a typical content lifecycle?
  • What are some best practices for designing a conceptual diagram?
  • What do hiring managers look for in an entry-level tech writer?
  • What is a style guide?

Tutorials

  • How do I know that I am following a style guide?
  • How can I set up a basic docs-as-code environment (Markdown/Jekyll)?
  • How do build keyword libraries in DITA?
  • How do I set up a basic glossary?
  • What are some best practices associated with designing authoring templates?
  • What are some best practices for annotating your markup?
  • What are best practices for organizing my print portfolio?