Contents
Special Reports
Reading Usable Help
@UsableHelp on Twitter
Gordon R. Meyer
Copyright 2002-2015
Favorite Sites
Grammar Girl's Quick and Dirty Tips for Better Writing
Wiki-based Documentation: Tastes Great, Less Filling
The article The Trouble with Delivering Product Documentation in Wikis—and Some Better Alternatives by Paul Wlodarczyk pretty much tells you everything you need to know in its title. Wlodarczyk refers to "some Linked In posts" discussing how to publish documentation using a wiki, and then expresses a view that can be summarized as "wikis are not commercial content management systems." Well, he's right, but in situations where a pricey, hosted service isn't necessary, you might turn to the open source world for working examples of wiki-based documentation. You don't have to look too hard, but TinyMCE, Cisco's Documentation Wiki, or any site using DokuWiki would be a good start.
See also An Example of Wiki-based Instructions.
Posted: December 30, 2012 link to this item, Tweet this item, respond to this item