It's what Confluence was built for.
I currently use it in a consultancy role at a client site. From a perspective of documentation for technical documentation then (also as an auditor) I can definitely say it is 100% fit for purpose. Just for it's inbuilt history and tracking of updates by people it lends itself to replacing MS Office type documents.
There are a number of key addons/macros I use
Multi-excerpt. - Allows you to re-use text throughout the site. As an example have a page called 'roles and responsibilities' and have different items for each position. Do it once, propagate everywhere
Keywords - Good for acronyms, again write once, re-use everywhere.
Scaffolding - Many macros; but one implements the concept of 'Live templates' In a nutshell if you apply something on one page it is changed everywhere. Used with the Scaffolding data it is a very powerful Confluence addon.
Having used Confluence for about 3 years now, I have tried various ways of presenting company documentation, whether it be policy, process, procedure or technical documentation. If used consistently and by all stakeholders, then in my mind it is a replacement for Word, Excel, Powerpoint, Visio with all of the nuances of maintaining documents and keeping them current. As an auditor, it's a ready made evidence tool.
I'm with Steve. I'm a technical writer who has used Confluence in a number of organisations as well as other tech writing apps eg Adobe and I really prefer Confluence. Confluence has the flexibility to be used a number of ways not just tech dox.
There's a few issues though. It's a bit difficult to skin. You can add a company logo at the top of the page and change the theme to company colours but you need a plugin to do more than that.
If you have external and internal users on the one site it's not easy to secure pages. You can do it but it's not easy.
Also keep in mind the actual cost of Confluence is a lot more if you add up all the plugins you might need eg a visual editor like Gliffy which you might need for diagrams.
I'm just putting the negatives out there to keep things balanced, I still really recommend the application.
I'd also add that it encourages contributions too - one place I worked a few years back basically used it for everything. We actively encouraged people to write what they thought was needed, and also made them understand that everyone was responsible for improving their docs. Inline comments have made that so much easier since I left, and they're going to love the collaborative editing even more.
I think you're absolutely right about the "issues". Off the shelf, Confluence is an excellent match for what Greg (and you and Steve and I ) want, but you almost always need to look at some add-ons to extend the base product
I usually look at:
This community is celebrating its one-year anniversary and Atlassian co-founder Mike Cannon-Brookes has all the feels.Read more
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...
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!
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