Workflows to support Technical Documentation Writers

Would anyone be willing to share how they've integrated their technical writers into JIRA work?  We are a software shop and deploy small updates weekly (usually via feature flippers) and then big releases quarterly.  We've just started using JIRA and Confluence and expect to not use Confluence for Technical Documentation based on the needs of our clients.  So we are just interested in the workflows and fields you using for supporting your technical writers in doing their job.  Any advice or experiences you're willing to share.


2 answers

1 votes
John Paz Atlassian Team Mar 16, 2016

Tech Writer here! 

I've used JIRA in a variety of ways, but I find what is most important is that documentation is treated as something that happens alongside development, not as something that starts once development of a feature is done.


The simplest way to integrate documentation into a JIRA workflow is by creating a "documentation" component within the JIRA project. Any work that needs to be done for a feature, suggestions for improvement, or bugs can get labeled with the "documentation" component and queued that way to be worked on.


This method is probably least disruptive to the development process and maintains visibility of documentation work. Make the tech writer the component lead for that as well.


You can always get more complex if needed, by adding workflow steps to always include documenting a feature. Or you could create an issue type for documentation. That's the beauty of JIRA, you can customize just about anything. But using a new component is quick, easy, and effective. 

In one of our projects, we create a Sub-Task called "Documentation" so that we know that a particular Story needs a documentation to be created in our Confluence instance.

+1 on John Paz's answer.

Suggest an answer

Log in or Join to answer
Community showcase
Teodora [Botron]
Published Thursday in Marketplace Apps

Jira Inferno: The Nine Circles of Jira Administration Hell

If you spend enough time as a Jira admin - whether you are managing a single, mid-sized instance, a large enterprise one or juggling multiple instances at once - you will eventually find yourself in ...

247 views 0 11
Read article

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you
Atlassian Team Tour

Join us on the Team Tour

We're bringing product updates and pro tips on teamwork to ten cities around the world.

Save your spot