{"id":42,"date":"2009-05-31T20:59:40","date_gmt":"2009-06-01T01:59:40","guid":{"rendered":"http:\/\/www.smbitjournal.com\/?p=42"},"modified":"2009-05-31T20:59:40","modified_gmt":"2009-06-01T01:59:40","slug":"using-a-wiki-for-quick-documentation","status":"publish","type":"post","link":"https:\/\/smbitjournal.com\/2009\/05\/using-a-wiki-for-quick-documentation\/","title":{"rendered":"Using a Wiki for Quick Documentation"},"content":{"rendered":"

If your business is anything like the businesses with which I normally deal one of the hardest items to tackle is documentation.\u00a0 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.\u00a0 Businesses need good documentation for many reasons.<\/p>\n

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.\u00a0 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.\u00a0 These are not effective processes, but there is a simple solution.<\/p>\n

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

Wikis have now been around for several years and have begun to become popular in many businesses.\u00a0 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.\u00a0 You can really pick out a Wiki based on your particular needs.\u00a0 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.\u00a0 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.<\/p>\n

At first the idea of a Wiki is a bit foreign to most people.\u00a0 On the Internet we often encounter Wikis in use for system documentation.\u00a0 This is becoming increasingly popular. Wikis are often used to allow anyone to log in and make documentation changes.\u00a0 This can be a good way to get started with your Wiki.\u00a0 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.\u00a0 Your needs will depend upon your type of organization.<\/p>\n

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.\u00a0 The entire concept of the Wiki really encourages staff to make use of the format.\u00a0 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.<\/p>\n

A common feature amongst Wiki systems is the idea of tracking changes to Wiki pages.\u00a0 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.\u00a0 This feature also makes it very simple for a system administrator to roll back bad changes if someone is not posting appropriately.<\/p>\n

One of my personal favourite Wiki features is the idea of subscribing to a particular Wiki page either through email or an RSS feed.\u00a0 The subscription model allows any staff members to be alerted to changes to documentation in which they take an interest.\u00a0 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.<\/p>\n

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.\u00a0 Useful at every level of the organization and extremely simple.\u00a0 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.<\/p>\n

As I mentioned before, there are many Wiki products available on the market today.\u00a0 There are enough that choosing one is actually a rather formiddable task.\u00a0 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.\u00a0 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.\u00a0 There are so many Wikis from which to choose that the site WikiMatrix<\/a> is dedicated to helping you choose the Wiki that is best for you.<\/p>\n

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.\u00a0 Popular Wiki platforms include MediaWiki<\/a>, DokuWiki<\/a>, TWiki<\/a> and pmWiki<\/a>.\u00a0 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.\u00a0 The Wiki choosing wizard on the WikiMatrix web site is a great place to begin as well.\u00a0 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.<\/p>\n

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<\/a>, Alfresco<\/a> and Joomla<\/a>.\u00a0 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.<\/p>\n

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.\u00a0 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.<\/p>\n","protected":false},"excerpt":{"rendered":"

If your business is anything like the businesses with which I normally deal one of the hardest items to tackle is documentation.\u00a0 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.\u00a0 Businesses need good documentation for many reasons. Traditionally … Continue reading Using a Wiki for Quick Documentation<\/span> →<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[28,27,24,26,25,23],"class_list":["post-42","post","type-post","status-publish","format-standard","hentry","category-uncategorized","tag-documentation","tag-dokuwiki","tag-mediawiki","tag-pmwiki","tag-twiki","tag-wiki"],"_links":{"self":[{"href":"https:\/\/smbitjournal.com\/wp-json\/wp\/v2\/posts\/42","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/smbitjournal.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/smbitjournal.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/smbitjournal.com\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/smbitjournal.com\/wp-json\/wp\/v2\/comments?post=42"}],"version-history":[{"count":0,"href":"https:\/\/smbitjournal.com\/wp-json\/wp\/v2\/posts\/42\/revisions"}],"wp:attachment":[{"href":"https:\/\/smbitjournal.com\/wp-json\/wp\/v2\/media?parent=42"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/smbitjournal.com\/wp-json\/wp\/v2\/categories?post=42"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/smbitjournal.com\/wp-json\/wp\/v2\/tags?post=42"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}