This talk will present some tradeoffs with using a wiki as a collaboration or document sharing tool. Then it will proceed to assess DokuWiki as a wiki implementation.
David Weekly (of Super Happy Dev House fame) gave a nice introduction to wikis at Xerox PARC.
Executive Summary: Wikis were invented1) to facilitate building consensus.
We have ready access to LiveLink, SharePoint, CVS, and a Perspective Wiki. They're all capable of storing and presenting documents, with various tradeoffs.
| LiveLink | SharePoint | CVS | Writely | Perspective | |
|---|---|---|---|---|---|
| License | Expiring | Free? | Free | Subscr. | Free |
| Revisioning | Yes | Yes | Yes | Yes | Yes |
| Conflict Handling | Lock-based | ? | 3-way merge | ? | Lock-based |
| Ease of Use | Little | Little | Little | Medium | High |
| Browser Independence | No | No | N/A | Yes | No |
| Mature | Yes | Yes | Yes | No (stable) | No |
| Document Types | All | All | text vs. bin | HTML | XML |
| Printing | Native | Native | Native | Good | Web page |
| Microsoft Integration | Yes | Yes | No | Yes(close) | Promised |
| RSS | No | No | No | Yes | Yes (not here) |
Quick: You have to update the Project Management document in LiveLink. What do you do? You have to update the Liquid Runtime Connection document in SharePoint. What do you do?
But what exactly do you do?
First, either use a local rich client, or use Microsoft Internet Explorer, not necessarily your default browser. Navigate to the document, unless the repository supports inter-document search. Now you have to remember to “check out” the document from LiveLink, and how to do that. Work with the local copy. Edit the document (with a rich editor, yea!) and check in the new revision from your local copy.
That's too much work, for either of those two steps.
LiveLink and SharePoint introduce barriers high enough to affect document maintenance. You'll be shocked to learn that there are stale documents on our repositories. And documents go stale faster on repositories that are not second nature to the user.
Good wikis work with every browser. Who hasn't opened a web browser today?
Two independent clicks is twice as much work as one click.
The next generation tool will combine the findability of a Google Universal Desktop with the convenience of Amazon's Buy It Now button with deep integration with Microsoft Office.
Until then, we have to select the features that will benefit our problem space the most. And the most important feature is affordance. The wiki wants you to maintain it. It sits there, coyly suggesting you come hither and maintain its documents. They’re yours, after all. And you can’t do it wrongly. One click.
I did a deep comparison of tikiwiki, perspective and dokuwiki. Notably missing is MoinMoin and Nuxeo, both rather heavy weight.
<code C++> and XML)DokuWiki affords technical documentation better than the others. And that’s the most important attribute for what I needed.
~~DISCUSSION~~