Re: Wiki for Customer Facing documentation?

Subject: Re: Wiki for Customer Facing documentation?
From: Ruth Sessions <ruthsessions03051 -at- yahoo -dot- com>
To: Peter Neilson <neilson -at- windstream -dot- net>, "techwr-l -at- lists -dot- techwr-l -dot- com" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Wed, 3 Aug 2011 12:37:39 -0700 (PDT)

Regarding: Wikis for Customer Facing Doc

Compared with the editing markup options available in PDF or history/change tracking
options in Word and FrameMaker, wikis are primitive. (You can create PDF from almost
every HAT out there---Flare, AuthorIt, Word, FM (with MIFtoGo or Webworks), etc. 
I'm not sure about RoboHelp...)

Since there are so many types of wiki products, you might ask yourself
these questions before considering adopting a particular wiki for doc:
* Does it track changes and identify who made the change?
* Does it notify the author when changes to material occur?
* Can you easily approve/reject changes?

* Can it track versions of topics?
* Does it allow you to easily find and reuse existing topics?
* How would you use it in conjunction with source code control?
* Does it allow you to have conditional text? 
* Does it have any features to facilitate localization?
* Can you set it up to produce HTML compatible with different browsers?
Just food for thought. The few wikis I've worked with are not anywhere near the 
level of complexity of HATs.

Please tell us about your favorite wiki (or a wiki you use for doc) and  
the features that make it great. Would love to try it. Probably won't use it for doc,
but wikis do have their place and there are so many to learn about... 

:-)

Ruth 
------------------------------------------------------------
Ruth Sessions
603/886-7355


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com

---
You are currently subscribed to TECHWR-L as ruthsessions03051 -at- yahoo -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/ruthsessions03051%40yahoo.com


To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/ for more resources and info.

Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com

---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40web.techwr-l.com


To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/ for more resources and info.

Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat


References:
Wiki for Customer Facing documentation?: From: Matt Moore
Re: Wiki for Customer Facing documentation?: From: Robert Lauriston
RE: Wiki for Customer Facing documentation?: From: Matt Moore
Re: Wiki for Customer Facing documentation?: From: Peter Neilson

Previous by Author: RE: Anyone Can Write - Just Look At The Job Descriptions
Next by Author: Re: Hiding things (was RE: Optimizing OnlineHelp for Mobile Viewing)
Previous by Thread: Re: Wiki for Customer Facing documentation?
Next by Thread: Re: editing javadoc comments


What this post helpful? Share it with friends and colleagues:


Sponsored Ads