Tag Archives: twiki

Using a Wiki for Quick Documentation

If your business is anything like the businesses with which I normally deal one of the hardest items to tackle is documentation.  This can include all kinds of documentation from human resources processes to accounting practices to core business procedures to the information technology department’s system records.  Businesses need good documentation for many reasons.

Traditionally small businesses simply end up doing without key documentation and have to reinvent the wheel every time something comes up for which the people currently working have not had a chance to memorize the process.  Larger businesses often place their limited documentation into Microsoft Word or Adobe PDF files and store them away in an unsearchable file server or possibly even on paper – putting them into large, ringed binders that no one even knows exist let alone how to find necessary information within.  These are not effective processes, but there is a simple solution.

The solution is a web-based application known as a Wiki.  Most people get their first introduction to a Wiki through the ubiquitous online encyclopedia Wikipedia which is built on a Wiki platform (MediaWiki, to be specific), but this is hardly the only use for a Wiki.  Wikis are simple document repositories designed to allow many editors to easily create and modify online documentation.  The whole concept of the Wiki is about being simple and easy.  The full name, Wiki Wiki, means “quick” or “fast” in Hawaiian.

Wikis have now been around for several years and have begun to become popular in many businesses.  Wikis are generally very lightweight and there are many vendors making both open source and proprietary Wiki products in addition to several hosted services available online.  You can really pick out a Wiki based on your particular needs.  Most Wiki products are free and for the budget conscious business there is no reason to need to consider a Wiki to be a cost center.  This is a simple product that your IT department should be able to roll out for you quickly and easily giving you a documentation repository right away.

At first the idea of a Wiki is a bit foreign to most people.  On the Internet we often encounter Wikis in use for system documentation.  This is becoming increasingly popular. Wikis are often used to allow anyone to log in and make documentation changes.  This can be a good way to get started with your Wiki.  You can also start from the beginning with detailed user access controls allowing only certain individuals to post documentation in the system instead of allowing a documentation free-for-all.  Your needs will depend upon your type of organization.

What makes the Wiki concept powerful is the ease with which anyone can hop on, search for documents that they need and create or modify those documents if they cannot find the information for which they are looking.  The entire concept of the Wiki really encourages staff to make use of the format.  Lowering the barrier to creating useful documentation is the best possible way to get documentation created, and because the documentation is so easy to modify it makes it far more likely that that document will be kept up to date.

A common feature amongst Wiki systems is the idea of tracking changes to Wiki pages.  This means that if someone goes in and makes a change to a page that people using the Wiki system can view past versions of that document to see what changes have been made over time and by whom those changes were made.  This feature also makes it very simple for a system administrator to roll back bad changes if someone is not posting appropriately.

One of my personal favourite Wiki features is the idea of subscribing to a particular Wiki page either through email or an RSS feed.  The subscription model allows any staff members to be alerted to changes to documentation in which they take an interest.  These can be staff members for whom a particular Wiki page is critical to their job functions such as HR managers following changes to the corporate employment policies pages or just interested staff members who want to know when a page changes such as managers subscribing to the cafeteria’s lunch menu page or developers subscribing to a page about a particular software project’s status.

This method is a wonderful way to allow anyone to keep up with any publicly available knowledge without needing to interupt the actual process to view status.  Useful at every level of the organization and extremely simple.  So often organizations do a poor job of keeping everyone “in the loop” who needs to be and with the Wiki subscription model everyone has the opportunity to take responsibility for keeping themselves informed through whatever method is most useful to them.

As I mentioned before, there are many Wiki products available on the market today.  There are enough that choosing one is actually a rather formiddable task.  Some key differentiators between products include their use license, the data store architecture – typically filesystem based or database based, their platform dependence and their integration with other products and authentication systems.  Of course there is also the option of choosing a hosted Wiki service that hosts your Wiki online – mostly this is popular with companies using Wikis as a means of serving their customers rather than for private, internal documentation.  There are so many Wikis from which to choose that the site WikiMatrix is dedicated to helping you choose the Wiki that is best for you.

Before you dive into the world of exploring Wikis on your own I will mention a few that are rather popular and worth looking into early on in your Wiki decision making process.  Popular Wiki platforms include MediaWiki, DokuWiki, TWiki and pmWiki.  These are just the tip of the Wiki iceberg but provide a good look into the features that you should expect to see throughout your search for the best Wiki for your implementation.  The Wiki choosing wizard on the WikiMatrix web site is a great place to begin as well.  Each of these Wikis that I have mentioned thus far are available for free and rather than spending a lot of time studying their benefits you may wish to simply download one or more of them, install them on a spare server and give them a try.

In addition to stand-alone Wiki products like we have mentioned here there are also Wiki engines built into several enterprise content managment and portal systems such as Microsoft’s Sharepoint, Alfresco and Joomla.  For any businesses looking to make a larger investment in an enterprise content management system having a Wiki functionality built into that product can provide a single, unified Intranet web portal interface to serve many different internal documentation and document storage needs.

Wikis are powerful and affordable tools that small and medium businesses can leverage today, even in a climate of budget cuts and uncertainty, to document processes, ease documentation burdens and increase internal communications and efficiency.  It is unlikely that we will see the popularity of the Wiki concept wane but rather they are already beginning to take their place as a staple of the business documentation and communication process.