Approach to requirements in Confluence + JIRA

Hi all,

I think I double-posted this. Meant for it to be a question, not a discussion, although I guess it doesn't really matter which.

We're just about to start using confluence and jira for our SDLC, and we're trying to map out how this process will work the best. In our organization, normally we have product managers defining epics. Then product owners/analysts will take those epics and break them down into individual stories, which will then go through the normal life cycle.

What I'm thinking initially for our handling of this process in Atlassian is something like this:

  1. Create a space in confluence for the requirements related to Product A. (No problem. Done.)
  2. Product Managers create requirements pages in Product A, one page for each feature of Product A. So call it for now "Product A Home Page." 
  3. Within the requirements page, Product Managers will document the high level requirements, with somewhere near the top of the page listing the overall feature name, e.g. "Product A Home Page". The requirements table below might have 5 high-level requirements underneath. They will then use the built-in Jira link functionality to link the place where it says "Product A Home Page" to a new Epic in JIRA.
  4. In JIRA, the Epic will get assigned out to an analyst, who will review the epic and create stories from the requirements in the Epic as appropriate.

Does this flow in general sound doable? Am I going down a problematic road for some reason? Is there a better approach?

Ultimately we want a Confluence page for each feature that will always display the most up-to-date product requirements for all features. We also want the requirements to link easily to JIRA so that it's easy for people to get back and forth between individual JIRA stories or tickets and back to the overall requirements page / Epic.

(Considering adding Yogi to help with the integration.)

Like I said, brand spanking new to this, but if I can gain some lessons learned from people who have gone here BEFORE we screw it all up, that would be great!


1 answer

1 accepted

Your process seems very doable. I would suggest customizing a template for the Product Requirement page as to ensure consistency and to best capture data and elicit requirements that are most relevant to your team.

I would have BAs create user stories vs use cases (i.e., As a user I would like a large Pay button on the homepage of the website). Additionally, you might want to throughly plan what the nomenclatures of each page will be so that users can easily identify the content they are searching. Since your team will use the SDLC process you might want to try naming the pages as such Feature 1: Inception, Feature 1  Elaboration, Feature 1 Construction, Feature 1 Transition. 

Documents should be housed under each section accordingly:

  • Inception (e.g., requirements/scoping, sign-offs etc)
  • Elaboration (roadmap, architecture/design, risk register, sprint planning/meeting notes)
  • Construction (development, testing info)
  • Transition (user acceptance, retrospectives)

Of course information such as requirements can change at any step of the SDLC however the above will give stakeholders not only an improved understanding of expectations during each stage of the SDLC. Products Owners hopefully are deterred from adjusting the scope once the team is in the elaboration/construction phases. 

Link pages to issues will certainly help users navigate to the information they seek; however, when a JIRA issue is mentioned on a page an automatic link is created on the JIRA issue. Also, users can auto create JIRA issues from Confluence simply by highlighting plain text. This will help prevent double entry - once the PO agrees on the requirements the BA can convert them to user stories that will generate issues in JIRA. No worries if the user is already in JIRA, you can add a link to Confluence from JIRA by clicking the edit button on any issue, selecting "Link" and following the prompts.

Last as an added benefit to your team and leadership I would suggest using Tempo or another time tracking add-on to gather the cost of a project and to get better at estimating.

Suggest an answer

Log in or Sign up to answer
Community showcase
Published Mar 12, 2019 in Confluence

Confluence Admin Certification now $150 for Community Members

More and more people are building their careers with Atlassian, and we want you to be at the front of this wave! Important Dates Start the Certification Prep Course by 2 April 2019 Take your e...

298 views 2 13
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