Using Confluence for agile engineering documentation

We have a long history of keeping design specifications as Word documents, which are currently stored as attachments in Confluence. We use Arsenale's Lockpoint plugin to lock/unlock as needed (there's a long history of SharePoint use and we have had to ensure "parity" for some key features). My team would like to natively use Confluence pages for design specifications with a custom blueprint, but we're struggling to find a workflow that gives us most of what we have now:

  • Specs per version/release
  • Inline comments (yay 5.7 release!)
  • Commenting that is tied to a specific revision/version of the content (e.g. comments from the 2.2 release aren't still sticking around in the 2.3 version's document)
  • Restricted draft visibility

I read through the Developing Technical Documentation page, and have evaluated the Scroll Versions and Comala Workflows/Publishing plugins. It seems like Scroll Versions might be sufficient given a dedicated space for the documentation, though there is hesitation to bite off the price for the size of our confluence install (2000 user enterprise, with a team of a dozen who need the functionality).

Are there other options that don't involve doing a space copy every time we cut a new branch/release? Is anyone else using Confluence natively for their engineering documentation?

1 answer

Hi @Matt Shelton,

Our add-on Yoikee Creator allows you to create space templates (i.e., space blueprints) by means of mind maps. You draw the structure of your space template in a mind map, where the nodes become pages in the space. Thus, the hierarchy of nodes-sub nodes become the structure of pages-sub pages in the space.

So, you create once a mind map, and you can create as many spaces as you need with the same structure of pages (consistent spaces). Don't need doing a space copy every time!!

We are about to release the 2.0 version (this month), where you can choose page blueprints in the nodes (JIRA reports, blog post, file list, etc), mind maps can be embedded on pages (with a macro), new rendering engine, and many more new features.

Give it a try and send us feedback!



Suggest an answer

Log in or Sign up to answer
Community showcase
Published Nov 29, 2018 in New to Confluence

How to use Confluence Cloud for stakeholder management

Most of us don’t need much convincing that stakeholder management is important. It just makes sense that keeping everyone in-the-know on projects and assigning clearly defined roles is key to having ...

1,187 views 4 6
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