Monday

Write a Documentation Plan

Today I plan the next release of my documentation, which I must have ready when the product is ready. Generally, I write a documentation plan with the following details:

• The intended audience.
• The new features we'll need to document.
• A list of all documents we'll have to revise or create from scratch.
• The content or subject matter experts who need to review the documents.
• A preliminary schedule that includes the projects for each technical writer working on the release. Only two technical writers are working on this release.

I also identify important synchronization dates, such as shipping beta* documentation, sending all documents to review and signoff in Document Production, and finalizing all content before our Localization department starts translating. I will meet with the managers in Document Production and Localization to make sure we agree on important milestones.

The Document Production group verifies that we use the most recent templates so all NI documents look the same inside and out. They also double-check our formatting and create or edit difficult pieces of art for technical writers.

The Localization group is made up of translators from around the world who translate the English software and documentation into their native languages. We have translators from France, Germany, Japan, China, and Korea.

After completing the documentation plan, I ask the technical writers involved in the project, the project manager, and the content experts to review the documentation plan and provide feedback to make sure we understand and agree on the work involved in completing the project.

* Software and hardware products have two important development milestones: alpha and beta. Alpha marks the date that the product contains all of the features and is ready for testing and bug fixing. Usually, testing is done internally during alpha. When the team is confident that the product operates as they intended, they often ask customers outside of the company to test the product and report feedback. Technical writers sometimes prepare special documents for beta periods to explain the new features and how to access them.