Seeking advice/examples for starting a Knowledge Base from scratch in Confluence

Nikki Hylton
Contributor
July 18, 2024

Hello!

Our team is starting to explore creating a brand new internal Knowledge Base in Confluence to become the single source of truth for all of our internal job aids and process related documentation.  Right now, documentation is scattered across many different platforms and not intuitive to find. 

We've viewed the Atlassian documentation around Knowledge Bases in Confluences, but are still having a hard time on where to start.

Does anyone have any sample screenshots of internal KBs you've set up in Confluence you'd be willing to share for inspiration? Or any advice in general?

 

Thanks in advance!

Nikki

3 answers

2 votes
Kristian Klima
Community Leader
Community Leader
Community Leaders are connectors, ambassadors, and mentors. On the online community, they serve as thought leaders, product experts, and moderators.
July 18, 2024

Hi @Nikki Hylton 

This is our (Emplifi) story - hope you'll find it inspiring as you're in a similar position as we were 2 years ago.

The link points to an Atlassian Platinum Partner's site (K15t).

1 vote
Barbara Szczesniak
Rising Star
Rising Star
Rising Stars are recognized for providing high-quality answers to other users. Rising Stars receive a certificate of achievement and are on the path to becoming Community Leaders.
July 19, 2024

@Nikki Hylton One thing I would advise you to think about up-front is how you are going to make the content available to your audience.

I have been using Confluence to write a user guide for one of my company's applications. When I started (about 16 months ago), we were using the Free Cloud plan, since I was basically the only one using Confluence and we could add a few reviewers while still on free.

The plan was that, once the documentation was ready to roll out to the rest of the company, we would move to the Standard plan, with licenses for all who needed to access the guide.

This brought up the question of how to update pages when needed in the future without all those end readers seeing the changes before we were ready to publish them. 

Over the course of a year of participating in this community (thank you community for all your wisdom! 😀), I learned that there are 3rd-party apps that we could use to provide a website output that we could make available to our internal folks (you can also set it up for external readers).

It turns out that licenses for the 3rd-party app we chose for our people who will actually use Confluence for other purposes are much cheaper than getting Standard licenses for all the people who just need to read the documentation, so we decided to go that route.

Had I known up-front that we were going to do this, I could have avoided the hours and hours I spent figuring out how to work around some of the features in Confluence to format my docs how I wanted, as well as putting in features like TOC macros on each page that I now do not need (because my app provides alternatives or doesn't support some of the macros and features I used, and I am now spending time removing them.)

Nikki Hylton
Contributor
July 23, 2024

This is super helpful - thank you @Barbara Szczesniak ! Would love to know which app you went with if you don't mind sharing.

Like John Funk likes this
Barbara Szczesniak
Rising Star
Rising Star
Rising Stars are recognized for providing high-quality answers to other users. Rising Stars receive a certificate of achievement and are on the path to becoming Community Leaders.
July 24, 2024
Like # people like this
0 votes
John Funk
Community Leader
Community Leader
Community Leaders are connectors, ambassadors, and mentors. On the online community, they serve as thought leaders, product experts, and moderators.
July 18, 2024

Hi Nikki - I would love for you to document that process as you do it. That would be a great article/blog!!

Suggest an answer

Log in or Sign up to answer
DEPLOYMENT TYPE
CLOUD
PERMISSIONS LEVEL
Product Admin
TAGS
AUG Leaders

Atlassian Community Events