Creating Manuals/User Guides
Hi, Anyone has a good way of creating manuals/training/user guides? I've found HTML/Word very cumbersome and more or less useless so I'd like something "better". There is also a service (www.dozuki.com) that is the basis of iFixIt website that looks great and they use an "open source" format called omanual (http://omanual.com/) however there seem to be no parsers or content-creators that work with omanual except the one from dozuki and I don't feel like paying $150 a month for a service to host few user guides. Thoughts? Thanks, Corneliu.
Re: Creating Manuals/User Guides
I haven't tried it yet but we use a suite of tools for acceptance testing that are capable of automating the user interface and taking screenshots of various windows when test steps go wrong. I want to write a collection of "Documentation Tests" that when run produce a report that shows key scenarios end to end and takes a screenshot for each step as the basis for a visual walkthrough of the system. These tools are based off of Ranorex which is a commercial automation suite but you could probably achieve similar results with Project White or WatiN. On Tue, Oct 30, 2012 at 9:41 AM, Corneliu I. Tusnea wrote: > Hi, > > Anyone has a good way of creating manuals/training/user guides? > > I've found HTML/Word very cumbersome and more or less useless so I'd like > something "better". > > There is also a service (www.dozuki.com) that is the basis of iFixIt > website that looks great and they use an "open source" format called > omanual (http://omanual.com/) however there seem to be no parsers or > content-creators that work with omanual except the one from dozuki and I > don't feel like paying $150 a month for a service to host few user guides. > > Thoughts? > > Thanks, > Corneliu. >
Re: Creating Manuals/User Guides
DrExplain On 30/10/2012 12:41 PM, Corneliu I. Tusnea wrote: Hi, Anyone has a good way of creating manuals/training/user guides? I've found HTML/Word very cumbersome and more or less useless so I'd like something "better". There is also a service (www.dozuki.com) that is the basis of iFixIt website that looks great and they use an "open source" format called omanual (http://omanual.com/) however there seem to be no parsers or content-creators that work with omanual except the one from dozuki and I don't feel like paying $150 a month for a service to host few user guides. Thoughts? Thanks, Corneliu.
RE: Creating Manuals/User Guides
I've used help and manual v5 in the past for context sensitive help files and generating manuals. Version 6 is now available (which looks pretty good) http://www.helpandmanual.com/ Its not that cheap but work paid for it at the time. You could try their free trial and see it meets your needs. I have also used VSDocman, a visual studio plugin to generate technical documentation. http://www.helixoft.com/vsdocman/overview.html Regards Peter Maddin From: ozdotnet-boun...@ozdotnet.com [mailto:ozdotnet-boun...@ozdotnet.com] On Behalf Of Corneliu I. Tusnea Sent: Tuesday, 30 October 2012 9:41 AM To: ozDotNet Subject: Creating Manuals/User Guides Hi, Anyone has a good way of creating manuals/training/user guides? I've found HTML/Word very cumbersome and more or less useless so I'd like something "better". There is also a service (www.dozuki.com) that is the basis of iFixIt website that looks great and they use an "open source" format called omanual (http://omanual.com/) however there seem to be no parsers or content-creators that work with omanual except the one from dozuki and I don't feel like paying $150 a month for a service to host few user guides. Thoughts? Thanks, Corneliu.