What is the best template in confluence to write user story on it ?

[Basel Al Asal]

What is the best template in confluence to write user story on it ?

[Keith Sottung · Accepted solution]

The one you design for yourself?? :-) 

---

Here is mine. I use the page properties macro. Since the inputs can not be controlled, I've created a data entry key. You can see my example in attached images. If you do look at my example, I combine the best of Use Case and User Story together.  Love to hear feed back on this. :-) 

Before I sign off, let me stress this, a user story or use case template is needed, but regardless of design there must be a more seamless way to create a jira issue from the story.  A big question is do you leave the narrative in the confluence page, or do you copy over to a jira description. My preference is to leave the narrative in confluence and w/ a link to the jira issue.  Why, because the Product owners work better in confluence than jira, also confluence has better tools to track edits.  Last, I like using the page property to write the narratives, because if there is a need to extract all the narratives in to a table style report, then through page property reporting, I have the option. Looking forward to the debate... :-)  

[Basel Al Asal]

Thank you so much 

[Brian Raley]

Hello @Basel Al Asal 

I was at Atlassian for years and I always had that same question.  Everyone had their favorites.  So I made my own template with the best parts and would copy that one for all of my projects.  Now at SentinelOne with a team of 6, I have done the same and I shared with them my advice and experience, asking them to always use the template I designed for all our projects.   Our custom template reads the same and I know every part of the project is documented.

[Basel Al Asal]

Thank you so much

[Michel Neeser]

Hi @Basel Al Asal

As far as I know, there is no specific template for this because user stories are usually written directly as epics/issues in Jira (as already mentioned). But there is a template for product requirements which includes user stories, or you can always create a template yourself.

Hope this helps.

[Basel Al Asal]

Thank @Michel Neeser 

[Michael Schuetz]

User Stories are written in JIRA not Confluence

[Basel Al Asal]

In my company, we write it in Confluence

[Keith Sottung]

I respectfully disagree. :-)  Business owners are not good at using Jira. 

[sacha_fungkeefung]

@Basel Al Asal @Keith Sottung we have used both approaches (User Stories written in confluence and Jira). The challenge the team finds is tracking the refinement status of User Stories in confluence without having to constantly switch between tools. Any insights on a good process or how this is managed at you company?

[Basel Al Asal]

Once I finish the user story in Confluence, I linked it in JIRA ticket  

[Keith Sottung]

@sacha_fungkeefung In Jira cloud, it is possible to imbed the confluence user story page as a Viewable Page so the Jira user doesn't have to toggle between the Issue and the page. What a love more is that the Dev Team can have a conversation with the Product Owner via the confluence page comment or better yet, in-line comment feature. The in-line comment have a "resolve" flag so you can track all open questions to a resolution.   

[Basel Al Asal]

@Keith Sottung @sacha_fungkeefung  am use the customized template