Email
Like
Liked ×
Save
Private Content
Embed
Loading embed code…
We have emailed the verification/download link to "".
Login to your email and click the link to download the file directly.

To request the link at a different email address, update it here. Close
Validation messages. Success message. Fail message.

Check your bulk/spam folders if you can't find our mail.
Loading

+ Follow

Thinking Outside the Book: Wikis for Writing and Delivering Documentation

by DMN Communications

1,630 views

A wiki can be a powerful and flexible tool for writing and delivering documentation. This presentation looks at the tools, techniques, advantages, and drawbacks of using a wiki to create and deliver ...

A wiki can be a powerful and flexible tool for writing and delivering documentation. This presentation looks at the tools, techniques, advantages, and drawbacks of using a wiki to create and deliver documentation.

Accessibility

View text version

Categories

Upload Details

Uploaded via SlideShare as OpenOffice

Usage Rights

File a copyright complaint

3 Embeds 36

http://www.dmncommunications.com	19
http://wiki.prd.corp.tsx.com	11
http://www.slideshare.net	6

Statistics

Likes: 0
Downloads: 9
Comments: 0
Embed Views: 36
Views on SlideShare: 1,594
Total Views: 1,630

Thinking Outside the Book: Wikis for writing and delivering documentation
Documentation. It's a necessary evil.
These are the topics that I'm going to discuss in this presentation.
These pieces of glass represent various formats in which we deliver documentation. PDFs. Printed manuals. Online help. Web-based documentation. All good formats, but mired in a sometimes unnecessary level of complexity. On top of that, updates to the documentation often can't be made and deployed quickly.
Adam Hyde, the founder of FLOSS Manuals, mentioned to me that he noticed a lot of what he called tool fetishism in the technical writing world. I have to agree with him there.
A wiki can be as powerful a way for writing and delivering documentation as any of the so-called standard documentation tools out there.
According to wiki consultant Stewart Mader, 37% of all content on a corporate wiki is documentation of some sort. Why not leverage that even more?
Who uses a wiki for documentation? Here's a sampling.
How are those companies, and others, using wikis? Here are the kinds of documentation that are being put on a wiki, or written and published with one.
Structure. It's an important factor to consider when using a wiki for documentation.
Getting documentation into a wiki is relatively easy. And you're not limited to only using the wiki's built-in editor.
Some technical writers liken a wiki to a black hole. They say it's easy to get content into one, but nigh impossible to get that content out. Untrue.
Most wikis support output to some or all of these formats. That support may be built in, or might require you to install plugins.
The FLOSS Manuals project is an interesting one, and not just because its made using a wiki to write and publish documentation something of an art.
A wiki is an ideal vehicle for collaborating with the readers of your documentation. They have some very valid insights and experiences, so why not take advantage of them?
If they start using a wiki, technical writers will need to shift gears. It's not just a shift in tools, but also a shift in thinking and doing.
There are several keys to the successful use of a wiki for documentation. These keys include structure, the ability to baseline the documentation, making the wiki attractive to users, and having solid content. The last is the most important.
Are wikis ideal for every documentation task? No, they're not. There are a few situations in which you wouldn't want to use a wiki for documentation.
Wikis are a very powerful and flexible tool for delivering any kind of information. And they're especially good for delivering documentation.
Questions?
Want to learn more about us? Here's where you can.

Thinking Outside the Book: Wikis for Writing and Delivering Documentation Presentation Transcript

Thinking Outside the Book: Wikis for writing and delivering documentation Scott Nesbitt Partner, DMN Communications
37%
Questions?
Web site: www.dmncommunications.com Presentations: www.dmncommunications.com/presentations.php Blog: www.dmncommunications.com/weblog SlideShare repository: www.slideshare.net/DMN.Communications Twitter: www.twitter.com/dmnguys Resources on the Web