---
title: "Wikis in Documentation: Ann Gentle Asks, Can Wikis Stand Alone, or Must They Be Supplements?"
date: 2007-06-26
description: "$( document ).ready(function() { // Handler for .ready() called. $("
canonical_url: https://idratherbewriting.com/2007/06/26/wikis-in-documentation-ann-gentle-asks-can-wikis-stand-alone-or-must-they-be-supplements-only/
---
# Wikis in Documentation: Ann Gentle Asks, Can Wikis Stand Alone, or Must They Be Supplements?
[Ann Gentle](http://annegentle.wordpress.com/) of BMC has been researching the use of wikis in documentation. Although wikis have been around for at least ten years, they are finally getting more attention. [Ann writes](http://annegentle.wordpress.com/2007/06/26/wiki-research-for-an-article-about-tech-pubs-and-wikis/),

> It's funny, in an early blog post I wrote on the internal blogs at BMC I said that I did not see how wikis would be used successfully for technical publications. I have since changed my once low opinion of wikis but I still see them supplementing other documentation, not substituting completely for technical documentation. I'd welcome discussion about wiki as standalone or supplemental end-user documentation. What do you think? Should the merits of wiki for certain products win out as the exact right documentation for that particular product especially one either related to an Agile methodology or social media? Or are wikis relegated to an upgrade to the customer support forum with a kludgy way of entering the information and no good method for outputting an information deliverable worth reading?

### My Response

Lately I've had the opportunity to delve into SharePoint 2007, exploring its wiki, blog, and RSS functionality in depth. I'm convinced that SharePoint 2007 is the tool that's going to change the way enterprises view wikis. Right now wikis are mostly web tools popular among open source projects where remotely located project members contribute to the documentation. SharePoint 2007 provides the same wiki functionality wrapped into the secure SharePoint tool that corporations love.

### Top Reasons Why Wikis Will Increase in Popularity

I'm not an expert on wikis, but so far this is what I've noticed using the SharePoint 2007 wiki:

- **Wikis are fast. **This is literally what wiki means in Hawaiian. I think I can complete a documentation project in two-thirds the time using a wiki instead of a traditional help authoring tool.

- **Wikis change the perception of help.** Let's face it: online help has a bad reputation of being useless. Wikis provide a new format that can counter that perception and empower critics with the responsibility to act on their jabs.

- **Wikis draw upon collective intelligence. **Even if you only have a handful of contributors to the wiki, drawing upon collective intelligence from actual product users is invaluable. Just getting one edit can expand the usefulness of your documentation tenfold.

- **Wikis are convenient.** With wikis, you don't need to attach files to emails, compile an online help file, transfer folders to a shared server, decipher edits on paper, or try to interpret Word's track changes. Editing of the files by SMEs and editors is a cinch.

- **Wikis give the impression of being up to date. **Even if they aren't, wikis have more life. You can update them on the fly. One minor update to a page can renew the user's faith that the documentation is current.

- **Wikis have tremendous potential in the enterprise.** Think about all the documents that project members collaborate on in the enterprise. Wikis will make project teams much more efficient (and fun).

- **Wikis are a curiosity that merits experimentation. **Everyone I meet is curious about wikis. They look at them with a new-found wonder. That's worth something.