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

0 votes
Answer 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 votes
Joe 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
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...

922 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