Proper planning is essential to the successful delivery of a documentation project. And a good plan must clearly define the following:
- Purpose of the documentation and its scope
- Project schedule
- Resources responsible for content development and project co‑ordination
- Final deliverables
From my experience with documentation projects, here are some questions that I have found useful in project planning. Answering these five basic questions helps define the purpose, scope, and schedule of a documentation project.
- Why are you creating the documentation?
- Who are you creating the documentation for?
- What is the documentation about?
- When is the documentation to be delivered?
- What resources are available to aid in delivery?
Understanding why and for whom you are creating the documentation helps you define the purpose and objective of the documentation. What the documentation is about helps you define the scope and allows for better content management. The timeline (when?) for the documentation delivery and the resources available (including human resources, authoring tools etc.) help determine a realistic schedule.
Also, here are four additional questions to consider:
- Have you completed similar projects in the past and are there existing materials that you could leverage? (Templates/content that could be reused)
- How can project progress be monitored and reported effectively?
- What are the possible risks and constraints?
- How do you establish guidelines for communication with fellow content developers, content reviewers, and stakeholders in the project?
I hope you find this information helpful, and if you need assistance with your technical documentation project, please reach out. My team and I would be happy to assist!
About the Author
Follow on Linkedin More Content by Surya Nair