Patricio Pace
VP of Business Operations
Great ideas can come from anywhere. We’re building a process to harness that power and propel Pliancy forward.
Finding your purpose is not a one-and-done process. It evolves as you change—so here’s how we’re evolving.
Anibal Cabral
Consultant
Project management is often shrouded in mystery. We pull back the curtain on what it is and how PMOs can help teams succeed.
Dillon Head
Knowledge Lead
How was your first day of work? You can tell a lot from an onboarding experience.
Nicholas Thomas
Infrastructure Projects Manager
We all have a story to tell. It’s time to discover yours.
Kristine Fuangtharnthip
Brand Communications Manager
There’s no telling where a simple question could take you. Here’s why and how you should take the leap.
Finding your purpose is not a one-and-done process. It evolves as you change—so here’s how we’re evolving.
Marcus Olson
Founder & CEO
Project management is often shrouded in mystery. We pull back the curtain on what it is and how PMOs can help teams succeed.
Katherine Ruckstuhl
Manager, Strategic Initiatives
There’s no telling where a simple question could take you. Here’s why and how you should take the leap.
Mark Wagner
Escalations Manager
Creating an internal knowledge base is easier said than done. Learn how to create a successful resource out of a pool of information for your internal team.
How do you organize information in your company? Who has access to it, and is it easy to find what you’re looking for? Is there a standard process for reviewing and updating information? For many companies, the answers to these questions are murky at best.
As Pliancy’s Knowledge Lead and one of Pliancy’s early employees, I’ve been involved in multiple iterations of our internal knowledge base (or KB for short). We’ve created hundreds of articles to boost the learning experience and answer questions for our internal teams. Getting started with a KB is not easy and takes time and effort.
When all is said and done, it makes a difference when everything comes together and the readers—the internal team—have resources to look back on for their success.
We all have our own, everyday superpower. It could be remembering the name of everyone you meet; knowing where to go without a map; or choosing a perfectly ripe avocado every single time. My superpower is connecting with others.
I’m not just talking about chatting with the barista during the morning coffee run or getting a smile out of a TSA agent (though those moments are nice too). I’m talking about moments of genuine human connection—the kinds of connections that can transform a relationship.
Knowledge management is exactly what it sounds like—collecting, coordinating, and maintaining information for a group or organization. This can include both technical knowledge and operational knowledge.
A central repository for information, known as a knowledge base, is a vital component of knowledge management. Company knowledge bases can be external (public, client- or customer-facing) or internal (private, for employees and team members). Though our KB is primarily for internal use, many of the principles below will apply to both internal and external knowledge bases.
Internal knowledge bases aren’t only useful for the employee onboarding process; they’re a treasure trove of self-service information for longtime team members and new hires alike. KB content can include cheat sheets for new employees; training materials for new managers; benefits info such as plan summaries and time-off policies; historical reference materials; and client details for cross-functional collaborations.
Our knowledge base currently has over 800 articles on topics varying from our benefits package to information security. It’s managed by a team of two, and over 80% of it was written by the very professionals who use the information. The content is regularly reviewed and updated for accuracy, has a better than 95% employee adoption rate in any given month, and is heavily leaned on by leadership whenever we need to disseminate information.
I’m proud of what we’ve built. Do we get it right all the time? No, of course not. But through more than a little trial and error, we’ve learned what we want to build, what works for us, and what doesn’t.
As daunting as the task may seem, you don’t need a dedicated Knowledge team to start prioritizing knowledge management at your organization. You just have to commit to a few simple principles, then dive in.
If you’re reading this post, I suspect you’re in one of two positions:
Whatever brought you here, we probably agree on the importance of high-quality documentation that our team members and clients can rely on. The reality is that KBs are hard to build and even harder to maintain—but that doesn’t mean it’s impossible.
When founding an internal knowledge base, embrace accuracy, organization, and formatting.
No information is often better than incorrect information. Misinformation in a knowledge base can spread throughout an organization quickly. Prioritizing the quality of your information will help minimize the risk of “bad” information taking root.
You can’t use information if you can’t find it. Functionality is the name of the game, and this boils down to grouping content logically and consistently. There are a million different ways to design this system. Pick what works best for your company and, more importantly, stay true to that system. (In other words, don’t make changes to your KB’s organizational system or hierarchy lightly.)
Well-formatted—and consistently formatted—information is easier to understand and more enjoyable to consume. Content should feel similar across the KB, regardless of authorship. Examples to consider include how articles are structured and the overall tone of all content. As with organization, consistency is key regardless of your choices.
It seems remarkably simple, but I’m sure many of us have worked at companies where one or all of these items are afterthoughts at best. When that happens, the cracks show up fast.
There’s an entire conversation that could be had about which documentation software is best, which integrations to use, which organizational structures are the easiest to navigate, and the most appealing way to style instructional content—but that often boils down to preference.
Similarly, there are a lot of user-friendly ways to order and present information. When building a KB, the trick is to make decisions early and stick to them, whatever they are. No matter what choices you make, accuracy, logical organization, and consistent formatting are foundational and exist in their own realm, independent of our opinion-laden ideas.
Speaking of opinion-laden ideas: we’re certain about the importance of accuracy, organization, and formatting. It’s technical writing canon. But we’ve made a couple of key decisions that have helped us keep those three pillars at the core of the system while scaling our company.
To capture information in its most accurate form, the people who know the most should write the most.
Usually, the people using information know more about it than a technical writer ever will. For example, let’s consider the good ol’ automobile engine. Interviewing mechanics and writing about engines will teach you a lot. But a mechanic will have a nuanced understanding of their craft, even if they stink at describing it to laypeople, that a writer couldn’t attain from research alone. You can’t get the context dialed in without being down there in the engine’s guts, turning screws, and knocking things around.
If you need to document the procedure for changing a water pump on a V8, and a mechanic tells you they want to write it, why get in their way? That’s exactly what a lot of organizations do, simply because the expert is unlikely to be concerned about taxonomy or a meticulously defined style guide. But what’s more important: accurate information with all the gotchas included, or avoiding a bit (or even a lot) of editing later on? Hopefully you know by this point that I suggest biasing for accuracy every time.
If you’re lucky, maybe you have a subject matter expert on staff; someone who used to work on the front lines of your company or industry before they got tired of making an honest day’s wages and decided to start writing about it. You can, and should, lean on their expertise (shout out to my Knowledge partner, our Technical Content Producer, and former consultant, Rich Friedland).
Even if you have a Rich of your own, you’re still trying to document a vast domain of knowledge. Documentation and content work may include support for teams as varied as finance and engineering. In this paradigm, empowering your teammates to author documentation is essential to creating a robust and sustainable KB.
Knowledge management isn’t a solo endeavor: it’s a team sport. You need colleagues to identify what’s important, experts (and/or technical writers) to write that documentation, and a knowledge manager to make sure the information is both locatable and presentable.
Knowledge management exists, in part, to preserve institutional knowledge. It is a precious resource that should be preserved and guarded as such—that’s why we value safekeeping over gatekeeping.
Curation woes are the most significant consequence of not gatekeeping. Well-meaning folks can misunderstand what’s valuable to the company from a knowledge curation perspective. This creates static in the KB, but it’s a hazard we acknowledge and resolve as we’re able.
In our internal knowledge base, I estimate there are about 50 articles that might not be needed. This represents only about 6% of our total content. Given the choice, I’d much rather have 750+ necessary, quality documents with 50 duds rather than a scant 200 docs and no static.
A company knowledge base should focus on unique information that isn’t available anywhere else.
Any information available on the first page of a Google search is not knowledge base material. A KB’s job is not meant to be a gigantic one-stop-shop for all information. Regardless of whether a knowledge base is internal, public-facing, or both, its content should be information that is specific to your organization. Unique company information might include how your product works, what your health benefits are, or the iron-clad rules for your company’s hyper-competitive Halloween costume contest.
It can be tempting to document third-party tools. But unless Excel’s documentation is missing a critical piece of info that your team crucially has to have, don’t waste your time.
Here are some examples of topics that should and shouldn’t be included in a knowledge base:
Include
Avoid
You don’t require a technical writer or professional content slinger to start building a great KB. You only need a deliberate process that places accuracy at the top of a triangle, with organization and formatting falling in line underneath.
On behalf of technical writers everywhere, I think I’m contractually obligated to say: hire us, please. (Most of us are English majors with families that we’re honor-bound to wave all non-unemployment-office paychecks in front of.) But just between you and me, reader? You can get away without hiring a technical writer for a little while, especially if your resources are limited. As long as you have a knowledge management strategy and someone to keep you in line with the three pillars of KBs, I like your chances.
Many people view security and user experience as diametrically opposed. It doesn’t have to be that way.
Finding your purpose is not a one-and-done process. It evolves as you change—so here’s how we’re evolving.
Marcus Olson
Founder & CEO
Project management is often shrouded in mystery. We pull back the curtain on what it is and how PMOs can help teams succeed.
Katherine Ruckstuhl
Manager, Strategic Initiatives
There’s no telling where a simple question could take you. Here’s why and how you should take the leap.
Mark Wagner
Escalations Manager
How much more could you achieve by focusing on the work that fuels you? We’re reimagining support systems as a necessity for progress.
Finding your purpose is not a one-and-done process. It evolves as you change—so here’s how we’re evolving.
Marcus Olson
Founder & CEO
Project management is often shrouded in mystery. We pull back the curtain on what it is and how PMOs can help teams succeed.
Katherine Ruckstuhl
Manager, Strategic Initiatives
There’s no telling where a simple question could take you. Here’s why and how you should take the leap.
Mark Wagner
Escalations Manager
There’s no telling where a simple question could take you. Here’s why and how you should take the leap.
Finding your purpose is not a one-and-done process. It evolves as you change—so here’s how we’re evolving.
Marcus Olson
Founder & CEO
Project management is often shrouded in mystery. We pull back the curtain on what it is and how PMOs can help teams succeed.
Katherine Ruckstuhl
Manager, Strategic Initiatives
There’s no telling where a simple question could take you. Here’s why and how you should take the leap.
Mark Wagner
Escalations Manager
Type content here
Finding your purpose is not a one-and-done process. It evolves as you change—so here’s how we’re evolving.
Marcus Olson
Founder & CEO
Project management is often shrouded in mystery. We pull back the curtain on what it is and how PMOs can help teams succeed.
Katherine Ruckstuhl
Manager, Strategic Initiatives
There’s no telling where a simple question could take you. Here’s why and how you should take the leap.
Mark Wagner
Escalations Manager
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Urna porttitor rhoncus dolor purus non enim praesent elementum. Elit ullamcorper dignissim cras tincidunt lobortis feugiat vivamus at. Adipiscing bibendum est ultricies integer quis. Natoque penatibus et magnis dis parturient montes nascetur ridiculus mus. Risus feugiat in ante metus dictum at tempor commodo ullamcorper. Adipiscing elit ut aliquam purus. Et malesuada fames ac turpis egestas maecenas pharetra. Tortor at risus viverra adipiscing at in tellus integer. Nunc aliquet bibendum enim facilisis gravida neque convallis a. Leo duis ut diam quam nulla porttitor massa. Facilisi etiam dignissim diam quis.
Nec dui nunc mattis enim ut. Sit amet facilisis magna etiam tempor orci eu lobortis elementum. Orci nulla pellentesque dignissim enim sit amet venenatis urna cursus. Duis tristique sollicitudin nibh sit amet commodo nulla facilisi nullam. Vitae auctor eu augue ut lectus. Dignissim diam quis enim lobortis scelerisque fermentum. Sollicitudin ac orci phasellus egestas tellus. Volutpat diam ut venenatis tellus in metus vulputate eu scelerisque. Dictumst quisque sagittis purus sit amet volutpat consequat mauris nunc. Nec feugiat in fermentum posuere. At ultrices mi tempus imperdiet nulla malesuada pellentesque elit eget. Eleifend mi in nulla posuere sollicitudin. Eget nunc lobortis mattis aliquam faucibus. Placerat duis ultricies lacus sed turpis. Diam volutpat commodo sed egestas egestas. In iaculis nunc sed augue lacus viverra vitae. Imperdiet nulla malesuada pellentesque elit eget gravida.
Risus in hendrerit gravida rutrum quisque. Pellentesque pulvinar pellentesque habitant morbi tristique senectus et netus et. Ultrices gravida dictum fusce ut placerat orci nulla pellentesque dignissim. Vel eros donec ac odio tempor orci. Pharetra et ultrices neque ornare aenean euismod elementum. Pharetra massa massa ultricies mi quis hendrerit dolor magna. Vel eros donec ac odio tempor. Elementum eu facilisis sed odio morbi quis commodo odio. At augue eget arcu dictum varius duis. Aliquet sagittis id consectetur purus. Pellentesque massa placerat duis ultricies lacus sed turpis. Ut morbi tincidunt augue interdum.
test text
There’s no telling where a simple question could take you. Here’s why and how you should take the leap.
Finding your purpose is not a one-and-done process. It evolves as you change—so here’s how we’re evolving.
Marcus Olson
Founder & CEO
Project management is often shrouded in mystery. We pull back the curtain on what it is and how PMOs can help teams succeed.
Katherine Ruckstuhl
Manager, Strategic Initiatives
There’s no telling where a simple question could take you. Here’s why and how you should take the leap.
Mark Wagner
Escalations Manager
We all have a story to tell. It’s time to discover yours.
Finding your purpose is not a one-and-done process. It evolves as you change—so here’s how we’re evolving.
Marcus Olson
Founder & CEO
Project management is often shrouded in mystery. We pull back the curtain on what it is and how PMOs can help teams succeed.
Katherine Ruckstuhl
Manager, Strategic Initiatives
There’s no telling where a simple question could take you. Here’s why and how you should take the leap.
Mark Wagner
Escalations Manager