A quick guide to creating and showcasing best practices wikis
One of the largest challenges for an organization is the amount of knowledge that lives entirely in someone's head or inbox. It can be hard to pass that information forward, and no amount of knowledge transfer meetings can guarantee that what they know is available when you need it. That's where a best practices wiki comes in, acting as a repository of stored facts, processes, and tiny seeds of information waiting for the rainy day when you need them.
As with many notebooks, binders, and collaboration systems, it's easy to start with the best of intentions, but adding to a knowledge base like that creates more work for team members. The goal for today is to illustrate how to architect and implement a best practices wiki that's as low friction as possible, making it easy to contribute to, reference, and maintain.
A wiki for each team
There's a temptation to create a single Wiki Channel and have people pour all of their knowledge into it, but there are several advantages to using separate Wiki Channels for each team. Storing the Wiki Channel in a team Space lets the Space Administrators manage it or delegate management to other team members without requiring any additional access rules. It also creates a wiki in a familiar area, where people are already used to spending most of their day, so adding content isn't a departure from their routine.
Teams may even use several channels to organize best practices by duty or discipline. For example, in our own set of best practice wikis in Igloo Support, we keep one channel for corner case issues and fixes, and another for database queries and definitions. Separating them makes each one easier to browse or search, and keeps the division of content clear.
Content creation time-savers
Another virtue of using separate Wiki Channels for each team is that each channel can be configured with a distinct channel template, providing context for adding articles and ensuring that every item has the necessary information. Channel templates will accept HTML and tables, and support multilingual content, so no matter how complex your documentation needs are, they should be able to address them.
Another method we've seen clients use to save time and friction on article creation is by using email-enabled content. Setting an email address for the channel lets team members quickly send in an article, even if it's a notes to be built out later, quickly and easily from their inbox.
Creating an index
The Wiki Index widget lets you combine wikis from anywhere in your digital workplace, making it easy to display a title index on any Page or Space. Use it to create a cover Page for teams with multiple best practices wikis, or combine channels from multiple teams into a master index. The Wiki Index widget lets you have the best of both worlds, easily separated and categorized channels along with the ability to unify them whenever you need.
Here's an example of the index page we use internally in Support. It combines a Search Box widget, the Wiki Index widget, and several Add Button widgets to give us everything we need in a single location.
Collaborating around best practices
Building a best practices wiki is one thing, but maintaining it is another. Articles will need to be updated and maintain, and people need to know that there are articles they can check for the info they need. One of the simplest ways we see teams collaborate in these wikis is using in the comments to direct people to a particular article. It's an easy way to send them a link, and goes both to their email and to the mobile app.
Microblogs are a great way to share a best practice with the rest of your team. The Share a Thought button follows you throughout your Igloo, and lets you readily share items out with comments to any Microblog Channel. It includes an option to reference the current page, making it simple to link to the article you want to share. Share other teams' best practices to your department's microblog feed to find easy answers and collaborate.
Best practices wikis can create nexuses of expertise all over your digital workplace, and are often the first step in creating ad hoc repositories of knowledge that make onboarding and collaboration incredibly straightforward.
As always, if you have questions about the Igloo platform, workflows, or best practices, you can leave a comment here, or ask a question in the Community area.