Best Practices for Managing Knowledge Base Articles in Confluence?

[Harvey alex]

Hi all,

We’re setting up a knowledge base in Confluence Cloud and want to make sure it's easy to use and maintain. Any tips on structuring spaces, keeping content clean, or useful tools/macros you recommend?

Thanks in advance!

[Janine Jochum-Frenster_Aura Apps_]

Hey @Harvey alex 

Thank you for your question.

One of my colleagues has written a blog article on how to build a knowledge base in Confluence and which best practices can support you.

If you are interested in extending your Confluence instance with a third-party app, we will also show you how you can further improve your knowledge base with Aura Content Formatting Macros and make your content more appealing.

You can find Aura Content Formatting Macros in the Atlassian Marketplace.

Since my team is responsible for Aura Content Formatting Macros, you can always contact me for questions and suggestions. 

[Lukas Nicolai_Seibert]

Hi @Harvey alex  ☺️, If you're open to using a third-party app for your Jira Cloud instance, AutoPage could be a great solution for building knowledge bases effortlessly.

🧠 Many of our customers use AutoPage to create documentation such as:

• Knowledge bases by syncing Jira issues to Confluence
• Document best practices and retrospectives of past processes

⚙️ With predefined triggers, you can automatically generate Confluence pages directly from Jira issues - saving time and ensuring consistency.

You can find us at the Atlassian Marketplace ➡️ https://marketplace.atlassian.com/apps/1218503

[Zoriana Bogutska_Adaptavist_]

Hi @Harvey alex, Here are some recommendations I can share: 

- Try to keep the KB home page branded, engaging, and structured. To achieve that, you can combine built-in features (header, expand, tables, etc.) with advanced formatting apps like Mosaic, Ehavi, Tabs, etc. Mosaic, besides key formatting features (advanced cards, banners, backgrounds, tabs, numbered headings, etc.), provides a big base of full-page templates, including a home page for KB, team page, FAQs, onboarding, how-to articles, and more. 

- Make sure that all content in your KB has tags and is updated. Tools like Panorama can help you do this in bulk, saving you time and providing a holistic overview of all the content you manage. 

- Keep your KB interactive; You can collect feedback, post polls, and run quizzes using tools like Forms for Confluence. If your KB includes onboarding content, you can use Guided Pathway, which will allow you to guide new team members through key content in your KB.

- Increase your team's awareness of the KB using emails, team Slack channels, video meetings, or a Loom video to present the updated KB and, most importantly, the value your team can get from it.

- Track KB pages' performance: besides running surveys, you can track how many people visited your content and engaged with it. This information will give you insights into what areas of work with your KB need improvement. 

Please let me know if you have any questions or need help with Mosaic, my team created it :)

[Patricia Modispacher _K15t_]

Hi @Harvey alex!

Good questions! 

I'd love to recommend a practical content lifecycle guide, a dear colleguaue of mine is currently working on. It's all about these structuring tips you're looking for. 

K15t's documentation guide could also be helpful (though this version is targeted for DC).