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

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
Published Jan 08, 2019 in Jira

How to Jira for designers

I’m a designer on the Jira team. For a long time, I’ve fielded questions from other designers about how they should be using Jira Software with their design team. I’ve also heard feedback from other ...

1,086 views 4 9
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