Version UI a la Confluence documentation

How do you implement a version UI like the one in Confluence's documentation, which has a little menu in the upper-left corner? Can you set it up to reuse topics that have not changed from one version to the next?

All Versions

Confluence 4.0.x
Confluence 3.5.x
Confluence 3.4.x
More...

3 answers

1 accepted

Hi there, as Joe mentioned this is achieved by customising the Confluence Documentation Theme.

Details for how to do this are listed under step 4 on this page:

http://confluence.atlassian.com/display/DOC/Creating+your+Technical+Documentation+Space

In the case of Confluence.atlassian.com, we are including a page from another space for the list of versions. For example, the Confluence documentation includes this simple page into the left nav:

http://confluence.atlassian.com/display/ALLDOC/_All+Versions+of+Confluence+Documentation

You could customise the navbar to contain more or less anything you wanted, certainly a list of page titles wouldn't be too difficult. It could simply be a list of links on a basic page as in the example above.

0 vote
Joseph Clark Atlassian Team Oct 03, 2011

There is a configuration option in the Confluence Documentation Theme that allows you to customise the contents of the sidebar - this is accessible in the space administration section when the documentation theme is selected.

I'll see if I can get one of our tech writers to post an answer here describing how they achieved it on confluence.atlassian.com.

Do you reuse unchanged pages across release versions, so that if you found an error that applied to 3.4, 3.5, and 4.0 you could correct it once and all three would be updated?

Hallo Robert

No, we don't do that. It would become quite difficult to manage, unless the wiki provided some fairly sophisticated branching functionality similar to a source control tool. We keep the documentation for each major version in a separate space. On the whole, we maintain the space for the current release only, although occasionally we do update the archive spaces (for previous versions) when someone reports an error in the documentation, or an important workaround that needs noting.

Cheers, Sarah

How about integrating a source control tool to handle branching?

Suggest an answer

Log in or Sign up to answer
Atlassian Community Anniversary

Happy Anniversary, Atlassian Community!

This community is celebrating its one-year anniversary and Atlassian co-founder Mike Cannon-Brookes has all the feels.

Read more
Community showcase
Kesha Thillainayagam
Posted Apr 13, 2018 in Confluence

We want to hear how your non-technical teams are using Confluence!

Hi Community! Kesha (kay-sha) from the Confluence marketing team here! Can you share stories with us on how your non-technical (think Marketing, Sales, HR, legal, etc.) teams are using Confluen...

1,785 views 25 10
Join discussion

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