Feb 21, 2008
Day 12: Documentation
Your team can use a wiki to collaboratively write, edit, and assemble documentation. If you publish it electronically, consider letting your audience contribute to the wiki and help build the documentation:
WIKIPATTERNSA Practical Guide to Improving Productivity and Collaboration in Your Organization |
|
USING WIKI IN EDUCATIONCase Studies from the Classroom |
|
 Email  Twitter  RSS
Loading
|
RECOMMENDED WEBSITESSix Pixels of Separation • Before & After • Information is Beautiful • Brand New • Identityworks • Rough Type • Dear Times Square, • The Ministry of Type • swissmiss • Notes on Content • elliott.org • Berkman Center • Westminster Stories • johnaugust.com • Bobulate • gary's choices |
 |
PHOTO ESSAYSClick the photo above, or choose a photo essay from the list |
Future Changes, ISSN 1934-3728, is licensed under a Creative Commons License. You are free to share and remix, as long as you give credit and share alike. Questions? Contact me. Comments © their original authors. This site is powered by WordPress, Media Temple, and Polar Bears.
Rebecca says:
Mar 3rd, 2008
Hi,
I am in the investigative stages of creating user documentation using a wiki. I currently have a multi-chapter FrameMaker document that I import into a HAT to create context sensitive help. How would I create a manual from multiple wiki pages?
Stewart Mader says:
Mar 3rd, 2008
Hi Rebecca,
I’m not sure what you’re referring to with the acronym HAT – can you give me more details there?
Thanks,
Stewart
Janet Swisher says:
Mar 11th, 2008
Hi Stewart,
HAT is Help Authoring Tool, which is a specialized program for creating online help for applications. Some of the top tools in this category are Adobe RoboHelp, MadCap Flare, and WebWorks ePublisher.
It seems likely that most wiki engines can export the content of the documentation wiki pages as HTML files, which could be imported by most HATs.
The tricky question is how to get the wiki-based Table of Contents into a format that a HAT would recognize as a TOC. For example, to produce Microsoft HTML Help (a.k.a. .chm, the standard help format on Windows), the TOC has to be in a specific structure of HTML 2.0 “li” and “object” tags. If the wiki doesn’t export in a format that can be easily translated into this format, you’re stuck recreating your TOC in the HAT.
I’m interested in any examples you can share of actual projects that have generated print or online documentation from a wiki. Even if you can’t share names of companies or their products that are documented this way, it would be helpful to know what wiki engine and other tools they use.