Create
cancel
Showing results for 
Search instead for 
Did you mean: 
Sign up Log in
Deleted user
0 / 0 points
Next:
badges earned

Your Points Tracker
Challenges
Leaderboard
  • Global
  • Feed

Badge for your thoughts?

You're enrolled in our new beta rewards program. Join our group to get the inside scoop and share your feedback.

Join group
Recognition
Give the gift of kudos
You have 0 kudos available to give
Who do you want to recognize?
Why do you want to recognize them?
Kudos
Great job appreciating your peers!
Check back soon to give more kudos.

Past Kudos Given
No kudos given
You haven't given any kudos yet. Share the love above and you'll see it here.

It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

Adding Documentation as a part of workflow

The reason for this thought is usually we deploy the product but we fail to update the documentation for the same,whats the best possible way to make sure documentation is completed ,does adding documentation after UAT in the workflow logical ?

Currently we are adding an subtask,but I believe that's like an additional effort.What are you're suggestions

2 answers

2 accepted

0 votes
Answer accepted

You can include the documentation as a status in the workflow, for example, we also have this after the test phase.
As a tool for the documentation I would recommend Confluence. Here, a structure for documentation can be set up with little effort, such as requirements, solution design, changes, test and everything that would be important in the technical documentation. Here you can also easily store a summary of meeting logs and decisions made (there are simple templates for everything).
You can connect the Jira project with a Confluence Space via the tab "Project Pages". This way you can jump directly from the project to the Confluence documentation.

Later, you have the option to download this space in PDF or CSV or other formats and share it with colleagues or stakeholders if necessary, in case not everyone in your organization has Jira access or the documentation needs to be provided to customers.

 

Hope that helps a little bit. 

Kind regards, 

Charlotte

@Charlotte WilkeThank you, Yeah I do use Confluence for doc management and I am documenting the same activities as you have mentioned above,I was trying to lookup for different ideas or ways for avoiding missing document updates or creation ....like if its a part of workflow I would need to complete it before I mark as done.

Like # people like this

If you set the documentation as workflow status, you also have the possibility to visualize this workflow on a Kanban board and to move the issue cards to the next status, which makes the whole thing visually clear and attentive to open tasks.

I wish you much success working in the new Atlassian environment and for your projects!

Greetings Charlotte

Like # people like this
0 votes
Answer accepted

Hi @Dheemant  -- Welcome to the Atlassian Community!

@Charlotte Wilke describes a good way to manage documentation using Confluence, which makes it more convenient for a team to complete the work.

Have you paused to talk to your team about documentation issues, such as:

  • What do you do with documentation you create?  That is, why is it valuable to you?
  • Where in your process do you normally document?  For which step is documentation in  your definition of done/exit policy?  What else is in the definition of done that is skipped and why?
  • What does the team think are reasons documentation doesn't happen when expected?

The answers to these questions may guide your choices, and how you experiment to improve. 

For example, perhaps the team feels rushed/overloaded, and so take a "shortcut" to skip documentation.  For that situation it may help to make space and raise visibility to the value of the documentation.

Best regards,

Bill

@Bill SheboyThank You for the Guidance :-)

Like Bill Sheboy likes this

Suggest an answer

Log in or Sign up to answer
TAGS
Community showcase
Published in Agile

Join us LIVE: Atlassian & Experts Talk Research & Insights @ Scale

Hello all! What have you learned from your customers lately? Our live-streamed series continues by exploring CX, UX, and the power of research & insights at scale with Leisa Reichelt, Head of R...

249 views 3 6
Read article

Community Events

Connect with like-minded Atlassian users at free events near you!

Find an event

Connect with like-minded Atlassian users at free events near you!

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you