A reader asks,
Our documentation team often gets blindsided by changes that developers make. We don’t feel like we’re kept in the loop with the updates and changes that developers are making to the application. How can we plug into the developer’s worfklow?
Developers rarely make changes that aren’t tracked in a system like JIRA. (JIRA is probably the most common issue tracking system, but your team may use something similar.) I’m betting they also follow an agile workflow.
My recommendation for plugging into the developer’s workflow would be to understand agile better by reading Jeff Sutherland’s book Scrum.
At the start of a sprint (usually a two-week period of work), the project manager identifiers all the work that developers will do during the sprint.
You should look through the items in the current sprint to see which are doc-related. Then follow up with the developers assigned to each item to get the details.
Developers rarely make changes outside of the issues noted in JIRA. If they do, call them out on this. If developers are making silent changes that aren’t noted somewhere in JIRA, let the project manager know and remind developers not to do this.
Most agile environments have standup meetings each morning where the developers are supposed to say what they worked on the previous day, what they’re currently working on, and any impediments. Theoretically, standups can be a place where you get updates about what’s going on in a project.
Unfortunately, many project teams misunderstand the purpose of standups, and the meetings become lengthy problem-solving/discussion/idea-exchange sessions for developers that drag on 30-40 minutes, wasting the time of technical writers with unnecessary developer detail.
I wish I had a better solution for standups. Attending standups for different project meetings can be a bear on my productivity. It’s good to show a presence on the team, but if the meetings aren’t helpful, then maybe just attend them every other day (switching among projects). Spend the time analyzing items in JIRA and meeting with individual developers instead.
Get new posts delivered straight to your inbox.
I'm a technical writer based in the California San Francisco Bay area. Topics I write about on this blog include the following technical communication topics: Swagger, agile, trends, learning, plain language, quick reference guides, tech comm careers, and certificate programs. I'm interested in information design, API documentation, visual communication, information architecture and findability, and more. If you're a professional or aspiring technical writer, be sure to subscribe to email updates using the form above. You can learn more about me here. You can also contact me with questions.