Create
cancel
Showing results for 
Search instead for 
Did you mean: 
Sign up Log in

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

What is a recommended way to use Confluence to manage the documentation of a software system

What is a recommended way to use Confluence to manage the documentation of a software system with many COTS and custom components, released individually and collectively. How best to store and assemble it?

Assumptions:

  • Documentation includes install, upgrade, administration, and user.
  • Documentation is written as Confluence pages.
  • Code is developed and managed separate from documentation.

2 answers

2 accepted

1 vote
Answer accepted
Matt Reiner _K15t_ Marketplace Partner Jul 19, 2021

Hey @Craig Senior

May team has also put together a collection of best practices for creating documentation in Confluence. It's called Rock the Docs. I hope you find this helpful.

For documenting different components, some document all of them in one space, some in individual ones. Sort of similar to how we've broken up the documentation for each of our apps into individual spaces.

If you version each of your components separately, you'll want a versioning strategy for sure. You might consider my team's app Scroll Versions for this. You can also create variants of your content, so you could have just one documentation space that has some unique content displayed to admins or users.

Also, you could also Consider Scroll Viewport, which is the app we and Atlassian use to create our online help centers. It's all Confluence in the background, but your readers get a legit help center experience which your team can customize to fit your brand.

Also, I highly recommend the #confluence channel in the Write the Docs Slack. That part of the community is full of folks creating documentation using Confluence.

Now we're getting somewhere... Reading, I can see you understand the problem.

Like Matt Reiner _K15t_ likes this
0 votes
Answer accepted

Hi @Craig Senior , our apps' documentation is written and shared in Confluence - https://wiki.comalatech.com. We use our own app, Comala Publishing, to manage a publishing process that separates draft content from final content. Everything is published to space that has anonymous access, and thus is viewable by our audience. We also use an additional app, Refined Theme, to improve the UI and UX of the documentation. 

We put together a short video that talks about a similar use case (in this case, sharing HR documents, but the principles are the same): https://www.youtube.com/watch?v=-2DyjZDNja0

Best of luck, happy to provide more info if it helps. 

Suggest an answer

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

🏑 Atlympic Event: Confluence

Hello Community!  Quick disclaimer: We are running a contest on Community (The Atlympics!) from July 23rd - August 8th of 2021. If you are interested in participating in this contest (prizes! ...

412 views 16 13
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