The title has been chosen deliberately to suggest a process change in Agile Documentation within the overall Agile software development cycle.
Agile Documentation aims at enriching documentation iteratively that starts with a minimal viable draft. The Technical Writers and Customer Support function teams actively collaborate to figure out ways to improve the documentation. However, the key differentiator between the conventional form of rolling out documentation and Agile Documentation is the proactive approach to check how the documentation is perceived by its target audience.
Agile Documentation as a process has two components in addition to the existing documentation process – Customer Engagement and Backlog Grooming. Together with these additional components, the Agile documentation process would look like this.
Generally, customer engagement happens passively when documentation defects are found, or content enhancements are suggested, and not to forget unrelated issues.
In this new process, a Point of Contact would be appointed to oversee the rolling out of a release and identify if the users had challenges in using the documentation based on the product features. As a result, two inputs would generate:
This activity is similar to the software backlog grooming. Here, the two inputs from the Customer Engagement component will get converted into trackable backlog items. Additionally, the roadmap items will also be created.
Imagine a feature named Seasonal Allotment to be developed. This feature will preoccupy cargo capacities so that the booking capacity is properly adjusted. The feature will roll out in three steps:
Now, when the Seasonal Allotment configuration is ready for development, a placeholder concept topic, called Seasonal Allotment, will be sufficient. None of the stakeholders should be worried because the concept topic does not provide much details. The topic is slated to be documented not earlier than the first step and not later than the third step of implementation.
Agile Documentation in this process helps to get detailed and relevant feedback from the real time users.
Ravindra Dhumane has been a Technical Writer for over 18 years. He has worked in several domains such as banking, payments, financial products, and CRM. Although the user assistance content forms the major chunk of his work, content for marketing and presales is his personal favorite. Contact him on LinkedIn.
No Comments