Make Documenting Your Software Easier Than Ever Before
- Date: 2006-11-28 - Word Count: 870
Share This!
Here at M6.Net we’ve just released our new control panel software, allowing for easier and better control over our clients’ website accounts. It was my task to write the documentation for this new software. After working through it in a traditional word processor application and subsequently producing a final product that was of little use, we came to realize that there needed to be a better way to write a manual, and to release it in multiple formats. One of the lead developers sent a link my way and after trying the evaluation copy of the software I realized that it was the package that we needed. ‘Help and Manual 4’ turns manual writing and distribution into a very simple affair.
The Help and Manual (hereafter known as H&M) homepage (http://www.helpandmanual.com/) states that “Help & Manual makes producing help a pleasure” and this is a fairly accurate little catchphrase. When I first tried the evaluation version or edition 3 a while ago, it frustrated me that I had to copy and paste every page of the manual from the word processor into H&M. This was a daunting task even for our modest sized manual that runs just over 50 pages. With the newer version however, all I had to do was export the document to Rich Text Format and use the import feature in H&M. The software went off and did its thing, returning to me with a nice manual file broken into sections based on the various headings in the document. While there were a few minor layout glitches these were easily solved, and the overall benefit of being able to directly import the manual was a huge timesaver. While it took me 3 shifts (about 4 hours a piece) to import and format the manual manually, with the new version of H&M, I had it all looking and working nicely within a single shift and still had time to edit and modify the document.
The second feature that impressed me greatly was the sheer number of output formats available to the manual writer. The formats include HTML Help, Classic Winhelp, VStudio help, Browser based help (HTML pages), Adobe PDF, MSWord manual and eBook. There’s bound to be an option or two that are right for your manual. For us it was perfect. We could create an HTML file for online help, and a downloadable PDF version of the document for offline perusal. Each output style is fully customizable, particularly the document outputs which can be modified with a handy tool called the “Print Manual Designer”. This comes included with H&M and allows you to design the overall look of your manual in an easy and self-affirming way.
I’ve spent a while talking about the input and output options, but not the functionality. I’m pleased to say that the interface is straight forward and all the expected options (or at least all the options that I expected) are included. You control the layout in a tree structure on the left hand side of the screen. This determines the numbering of your sections in the final exported manual. Then there are the many standard formatting options like font attributes, tables, character insertion, image insertion etc, but there are also more unique media options. It’s possible to embed movie, sound, flash, and other files straight into your manual. This allows you to make a demonstration video illustrating the point the manual is trying to make and include it as part of the documentation. Obviously the viability of this depends upon your chosen output format.
There are a few unique tools that I thought were exceptional concepts. The first is the Syntax Highlighter that allows you to highlight code in your manual to look much the same as code in a development environment. I didn’t actually have reason to use it and test it, but I think the idea is a great one.
The second is the Screen Capture tool. This useful little gadget hides the H&M window and allows you to capture an image of any control or window in an open program by simply holding the Ctrl key and then clicking the window. This image is saved into your images folder and inserted into the manual. It’s quick and easy to use and saves a lot of time when compared to the alternative method (opening the program, hitting print screen, cropping the image to a desired size, and importing it into the H&M software).
Overall I was very impressed with ‘Help and Manual 4’. Beyond being a basic conversion tool, it makes it very easy to write your entire manual using just the functionality of the software. Once your information is all inputted there are many customization and layout options to get it looking just how you want it. When you’re done you can output it to many different formats. Help and Manual made writing and distributing our manual quick and easy. Check it out at http://www.helpandmanual.com
Pros:
- Excellent output options
- Comprehensive formatting tools allow complete control of a project’s look.
- Screen capture tool
- Good import options
Cons:
- There can be some formatting errors when importing from a document.
- You can’t select a network folder for your images folder. It is limited to your local hard drive(s).
Score: 4/5
The Help and Manual (hereafter known as H&M) homepage (http://www.helpandmanual.com/) states that “Help & Manual makes producing help a pleasure” and this is a fairly accurate little catchphrase. When I first tried the evaluation version or edition 3 a while ago, it frustrated me that I had to copy and paste every page of the manual from the word processor into H&M. This was a daunting task even for our modest sized manual that runs just over 50 pages. With the newer version however, all I had to do was export the document to Rich Text Format and use the import feature in H&M. The software went off and did its thing, returning to me with a nice manual file broken into sections based on the various headings in the document. While there were a few minor layout glitches these were easily solved, and the overall benefit of being able to directly import the manual was a huge timesaver. While it took me 3 shifts (about 4 hours a piece) to import and format the manual manually, with the new version of H&M, I had it all looking and working nicely within a single shift and still had time to edit and modify the document.
The second feature that impressed me greatly was the sheer number of output formats available to the manual writer. The formats include HTML Help, Classic Winhelp, VStudio help, Browser based help (HTML pages), Adobe PDF, MSWord manual and eBook. There’s bound to be an option or two that are right for your manual. For us it was perfect. We could create an HTML file for online help, and a downloadable PDF version of the document for offline perusal. Each output style is fully customizable, particularly the document outputs which can be modified with a handy tool called the “Print Manual Designer”. This comes included with H&M and allows you to design the overall look of your manual in an easy and self-affirming way.
I’ve spent a while talking about the input and output options, but not the functionality. I’m pleased to say that the interface is straight forward and all the expected options (or at least all the options that I expected) are included. You control the layout in a tree structure on the left hand side of the screen. This determines the numbering of your sections in the final exported manual. Then there are the many standard formatting options like font attributes, tables, character insertion, image insertion etc, but there are also more unique media options. It’s possible to embed movie, sound, flash, and other files straight into your manual. This allows you to make a demonstration video illustrating the point the manual is trying to make and include it as part of the documentation. Obviously the viability of this depends upon your chosen output format.
There are a few unique tools that I thought were exceptional concepts. The first is the Syntax Highlighter that allows you to highlight code in your manual to look much the same as code in a development environment. I didn’t actually have reason to use it and test it, but I think the idea is a great one.
The second is the Screen Capture tool. This useful little gadget hides the H&M window and allows you to capture an image of any control or window in an open program by simply holding the Ctrl key and then clicking the window. This image is saved into your images folder and inserted into the manual. It’s quick and easy to use and saves a lot of time when compared to the alternative method (opening the program, hitting print screen, cropping the image to a desired size, and importing it into the H&M software).
Overall I was very impressed with ‘Help and Manual 4’. Beyond being a basic conversion tool, it makes it very easy to write your entire manual using just the functionality of the software. Once your information is all inputted there are many customization and layout options to get it looking just how you want it. When you’re done you can output it to many different formats. Help and Manual made writing and distributing our manual quick and easy. Check it out at http://www.helpandmanual.com
Pros:
- Excellent output options
- Comprehensive formatting tools allow complete control of a project’s look.
- Screen capture tool
- Good import options
Cons:
- There can be some formatting errors when importing from a document.
- You can’t select a network folder for your images folder. It is limited to your local hard drive(s).
Score: 4/5
By Jesse S. Somer
http://www.m6.net/
Jesse S. Somer is a humanoid that sees the possibility of a society achieving incredible technical evolution, but which is still at one and integrated within a healthy natural world.
Jesse S. Somer is a creative writer working at M6.Net: ‘The web-hosting company for humans.’ M6.Net is working hard to help humanity experience the power and freedom to develop their own part of the Internet, to share their information and connect with anyone, anywhere, anytime.
Your Article Search Directory : Find in Articles
Recent articles in this category:
- Web Development Projects - Developers Tools Tips
Open source usually refers to software that is released with source code under a license that ensur - A Guide to Cnc Kits
Building a CNC machine means that you would require a lot of tools, parts or different components. - Xlphoto Printing, the Best Choice for Banner Printing and Poster Printing
Suppose, you have visited a tourist spot or a hill station; over there, you have witnessed some of - Reliable Software Programming
Software reliability is an important facet of software quality. It is defined as "the probability - Designing an Ecommerce Site
In a recent article I talked about Google AdSense placement based on eye-tracking research. Howeve - Asp.net Development Benefits
Rightway solution has been keenly looking out for. Microsoft ASP.NET is a free technology that allo - Choosing Offshore Software Development Company
To turn into successful and gain the full benefits of software outsourcing, you require preferring - E-commerce and Web Portal Development in Vietnam
VIETNAM, owing to its superior intellectual capital has emerged as the ultimate destination for - Types of Softwares
Computer software is a general term used to describe a collection of computer programs, procedur - Offshore it Out Sourcing Consultancy in Vietnam
Vendors who provide Off shore IT Outsourcing Consultancy services are referred to as outsourcing
Most viewed articles in this category:
- Oracle Applications (Oracle E-Business Suite) Customizations: What is it?
Oracle recommends every company that installs Oracle Applications to avoid any customization, but I - Offshore Outsourcing: An All Win Premise
The awareness that outsourcing can boost productivity sans forfeit of class has impelled MNC’s - Oracle E-Business Suite vs. Microsoft Dynamics AX - Axapta: LATAM and Brazil
In this small article we will only concentrate on Microsoft Dynamics Axapta (and will not consider M - SAP Business One vs. Microsoft Dynamics GP - highlights for consultant
In this small article we will not make side-by-side technical specs comparison. We would rathe - Microsoft Great Plains - licensing and product versions
Current Microsoft Business Solutions Great Plains has more that 10 years of history. Former Gr - OCR Software - Optical Character Recognition or Optical Crud Recognition?
Optical Character Recognition (OCR) refers to a software technology and processes that involve the t - Microsoft Dynamics AX - Axapta - technical notes plus customization
Axapta or current name Microsoft Dynamics AX has one of the newest ERP design and architecture among - Microsoft Dynamics AX-GP-NAV-CRM: trends and international recommendations
Microsoft Great Plains/Microsoft Dynamics GP, Microsoft Navision (former Attain) Microsoft Dynamics - Microsoft Moves to Small Business Accounting/Retail Market - stakes and thoughts
In this small article we will be looking at the new opportunities for Microsoft Small Business Serve - Microsoft Axapta - Dynamics AX: Brazilian Portuguese version - consultant highlights
Axapta/Microsoft Dynamics AX short overview. Navision Axapta was designed by Navision Software