Best way to write Requirements in JIRA or Confluence?


From a couple of weeks, we trying to find out a workaround how to write Requirements! We tried to achieve QMS! and pass audits! for that Reporting and Traceability at any level is the main thing.

We tried both ways by using JIRA and Confluence.

Method1 JIRA:  One Project for only requirements and Created three Issue Types for Requirements High-Level Req, System Level Req (Epic) and Detail Req (Stories) then we created actual work to track with a different project where Epic and stories are in Sprints etc, other Artifacts in confluence  

Method2 Confluence: Here all type of requirements be in only the confluence and used Requirements Yogi for unique ID and then linked those requirements by JIRA linking directing.

Any other way to achieve? advice needed!


1 answer

1 vote
Ryan Kearney Community Champion Apr 05, 2017

Hi Dave,

I would consider keeping your artifacts in their own project in Jira. That way you can configure a workflow (with approvals, etc.) and have more dynamic reporting. I also prefer method #1 you mentioned here. Although, if I were to describe it, I would say:

High level, conceptual requirements = epic

System level req = issue (could be story)

detail req = issue (again, could be a story)

Then your devs do the actual work in subtasks for the issues, showing daily progress on the subtasks.

I would utlize the epic links to tie issues back to epics. This will make your epic a dynamic list that shows progress across the other projects where the reqs live. 

I would need more information and context to provide a more in depth answer, but from your description I think this method would work efficiently. 


Thank you! Ryan.

Really helpful by your explanation!  

We brainstorming trying different approaches. If I have any more questions  I will post on here

Really appreciated for your quick response. 

Suggest an answer

Log in or Sign up to answer
Community showcase
Posted Oct 16, 2018 in Jira

Looking for anyone who made the switch to Data Center

The Jira Marketing team is putting together an ebook on migrating to Data Center. We're looking for pro tips on how you staffed your project team and organized your Proof of Concept. Share yo...

78 views 0 3
Join discussion

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