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.

Thanks.  

2 answers

1 vote
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 Sign up to answer
Atlassian Community Anniversary

Happy Anniversary, Atlassian Community!

This community is celebrating its one-year anniversary and Atlassian co-founder Mike Cannon-Brookes has all the feels.

Read more
Community showcase
Fadoua M. Boualem
Published yesterday in Trello

Using Trello to manage events

As a Jira power user, I was at first doubtful that Trello could benefit my workflow. Jira already uses boards (ones you can customize!), so why would I even need to use Trello?! In this post you will...

446 views 6 7
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