Using one Confluence Space by Artefact Version or one per Artefact

Hi,

we plan to use Confluence for Software Documentation.

Is it better to use it like Atlassian Style: One Space per Artefact Version.

Or is it better to use a Space per Artefact and then add all Versions to this Space?

Creating a new Version by copying an old subtree...

Is there a good documenten way for beginner? Video? Tuturial? Book?

Thanks!

Dirk

Next Step after Documentation an Requirements in Confluence is Setup of JIRA....

3 answers

1 accepted

Accepted Answer
1 vote
David Simpson Community Champion Jul 10, 2011

The answer is likely "it depends". Whatever works best for you.

Having said that, Atlassian's usage, where they copy the space for the next version does seem to be a good example.

One space per version means that any search within a single space (if you're using the space specific search box in the Documentation theme) is guaranteed to be specific to that version (assuming the documentation is correct).

Also, if you have all versions in a single space, you can't have multiple pages with the same title. This may prove to be a problem.

Hi David,

thanks for this answer.

Is there a simple way to search over all spaces?

Thanks.

David Simpson Community Champion Jul 10, 2011

@Dirk Bromberg: Do you mean all spaces, or all spaces for your product's versions?

The former is easy (try the search in the breadcrumb/header bar).

The latter, is also achievable -- try this search for "Upgrade" in 2 Confluence spaces. You'd like need to make your own user macro to get a decent form displayed.

I'think we will start with one space per version. Thanks.

Suggest an answer

Log in or Sign up to answer
Community showcase
Posted Thursday in Confluence

What are your project planning tips?

Hello Community,  Jessica here from the Confluence product marketing team! Today I wanted to get your takes on project planning –– what works, what doesn’t, how do you know if you’re doing it r...

165 views 0 3
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