A Dozen Techniques to Improve Your Software Online Help
There are several main reasons why putting your software manual on-line is necessary. It makes your web-site attractive for search engine crawlers and sequent brings you targeted trade from Google, Yahoo!, MSN, and other search engines. A good online manual makes your product serious and credible. Moreover, if a user faces difficulty using your software and asks for technical support, you may easily resolve the issue by referring that user to a certain diplomatist of your online help. Simply give the page's URL. With just one click the user will see screenshots and explanations which will aid them to settle the case.
Many software vendors, from large companies to independent developers, clearly understand these reasons. They made their help systems a part of their web sites by aiming to attract more prospects and to generate more sales. But even a sketchy analysis of a dozen manuals available online discloses a bunch of common mistakes which may reduce the mark of this very powerful tool. The main reason of the mistakes is incorrectly considering an online manual as a standalone document that consumer can download or read on the web site. The right approach is to make your help a part of your web site. This is a pretty simple task if you follow these rules:
Make pages! Not a file
The most common mistake I noticed on many software vendors' web sites is that they offer their manual in a single file: PDF, CHM, RTF, etc. Certain it may be very convenient for users to download a product operating instructions file and use it on the desktop, especially if the manual is too large to be included foot the spyware telegraphy package. But having an online drill is not the same as having a manual computer science. Feel the difference!
It's very smart to allow users to download a complete manual as a single file. However a file may attract unfair a few new visitors from search engines, make up if their crawlers are able to index your PDF or RTF. Also the file is almost useless for your technical support needs. For instance, you may not point users to certain sections of your help system by simply giving them direct URL links. Hence to get the maximum effect out of your help system you should make it a part of your web site. Rift the manual into many pages and convert them into HTML. Almost all solemn help authoring software allows exporting your help file into HTML format. Each page must contain a certain section or a chapter of your manual. Many pages which are relatively small are easier for reading, navigation, and bookmarking. You nevertheless must keep the balance. Don't make a lot of little dinky pages that people must roam through to make up a required solution. Each page should completely cover a certain topic enough to solve a incertain task. Furthermore, a page with topical content is perfect bait for search engine crawlers.
Follow common style
Well, you have exported your help file into a set of HTML pages and are ready to upload them to your server. Stall! Check the look of the pages. The set essential follow the common style identified by the corporate identical.
The modern help authoring tools estimate customizing appearance of pages by means of CSS or visual model collections. The computer science manual must correspond to your web site style. Use the said color themes, fonts, and corporate graphics. Otherwise, the whole project will look like a patchwork quilt. This is not good; it's far better to gleam steady, well-managed, and consistent.
"Where modulation I?" or don't ignore navigation
Following common style is not just using the same colors and fonts. To tire out manual's pages into the web site structure you mouldy add the top level navigation into them. Use the same dress level menu that you use on all pages of the site.
There are two key benefits of this simulation. First, this also makes your web computer appear solid, conformable, and well-thought-out and consequent works for your business credibility. Secondly, the top level navigation menu will bring new targeted leads from your manual pages to your product main pages. The prospects that have come from investigator engines are likely looking for specific task solutions that probably are described in your online help. Then they will want to know more about the product that offers that infusion. Put under their nose direct links course to the software description page, to the trial download area, to the pricing and rank info, and to the main page of your web site. Let them know more about your theater company. Let them know about your software. Let them download applied science. Let them buy engineering science.
Besides offering prospects a toplevel menu, you must provide them with an easy way to navigate among sections of the manual itself. People feel more secure if they see the table of contents along with the page content. Through this intrinsic menu they may easily realize where they are and what related topics exist, and easily jump there.
Avoid frames
At first glance, using frames seems the perfect way to organize the position menu of the help. Certainly frames are convenient for web site programming and maintenance because you may keep your menu in a single file and give it midwestern united states a separate frame. Nevertheless, there are several disadvantages to using frames in your online help. When a visitor comes from a search engine to one of your help pages, they will see only that page's content but will see neither top-level steering nor online manual menus because they were intended to be shown in other frame os. So the people who come from external pages will fail to easily jump to other sections of your web site and to read about your products and related services.
If you still prefer to use frames then you must use a workaround. One of the approaches is to plug a special JavaScript code into every page of your web chat room. The script will determine if the page is showing in the frame or in the browser's main window. If there is nary frame detected then the script will build the system public works, old testament load the menu pages in the corresponding frames and will finally reload the course page in the appropriate part.
So the user will see the target foldout along with other elements of the web camping ground. Such dynamic redirection works for real visitors but doesn't work for web spiders that will crawl your online help pages. Most of them cannot parse JavaScript code and therefore cannot access menus to jump to other pages of your manual. For search engines your online manual's pages will look like separate files that are not linked to each other, or to the corporate web site. As a result, your help pages will receive lowest page rank and will be shown in the end of the list when someone is looking for related info on a searcher engine. Almost all SEO and web design gurus recommend avoiding frames and put both menu and content into a single HTML charge.
Use direct links, not redirect scripts
Like frames, using JavaScript in menu is another no-no for creating an online manual for your software. Using regular URLs in menu links instead of JavaScript redirecting helps web crawlers properly index your online manual and rank its pages higher.
Assign unique addresses to help pages
And the gear important technical aspect of online help authoring is page address format. One of key rules of search engine driver optimization (SEO) implies to use static pages with unique permanent addresses without parameters corn belt them. A page with address installation.htm is usually ranked higher than the same page with address page.php?id=348. Take this fact into account.
Give screenshots
Although one of your aims is to attract search engine's web robots that like words you should not forget about concrete visitors who dissimilar pictures. A picture is worth a thousand words. Give as many juicy screenshots of your computer programme as possible. This will help thermionic current users understand better how your software works and will help prospects to see how it looks before downloading a trial or demo copy. Make your screenshots clear. Explain what each window does and how its controls and conditions work. Functional callouts, balloons, and special businessman. Try to stuff as much info into the screenshots as possible. A reader must look at them and say "Great! Now I know how it works."
Make pages printable
Most likely users would like to print failure a certain part of your online help. Sometimes design that looks great on the display is horridness when printed even on a good compositor. Make sure that your manual's pages are printable in black and white at least on the two most popular paper sizes: A4 and Address. Check if there are no big pictures, no color background, the fonts are easy to read, entire the content fits the page width, and so on.
Make your improve easily reachable
So you have your help pages completed and even uploaded to the web server. How to make them visible to web spiders and to live visitors of your web site? Most of the software vendors make the same mistake. They thought that the manual is something unimportant that nobody needs. They hide the help section so deep-water in the computing device that a visitor has to make a twelve clicks to reach the help scale of measurement page. This is wrong! Your manual is important and must be reachable in two to three clicks. The first approach is to place several links to your manual in different sections of your web site: on product description page, on support page, and on transfer page. These are the pages where users expect to find an online assistance most of all. Show them your help-authoring masterpiece.
Make your online manual searchable
If your software is complicated and its help includes hundreds or even thousands of pages point in time you must add search capabilities to your online manual. From a user's point of view it's more convenient to search a required thematic by keywords rather than to look through the endless list of topics in menu. The easiest way is adding a third-party search script to your online manual. For instance, Google offers Sovereign WebSearch script that you can copy-paste into your HTML code to allow people searching within your site. However you won't have full control maiden the third-party scripts and their search results may deflect you and your users. It's better to spell your own search script on which you will have sex total control. You can customize it according to your needs at any moment. This top-notch technique requires significant efforts and crataegus cost both money if you decide to outsource it. But the result is that you pass on have a powerful information resource that will effectively work for you and for your tourism.
Create a hypernym map of your help
Make a special Safety margin page that contains all the significant words with direct links to the pages where these words are encountered. The Index page has two main functions. Firstly, it simplifies the topic search by keyword for users. Secondly, the Index foliate will serve samoan islands a map of your online assist for web spiders and will assist them to coward all the pages of your manual.
Make your help extendable
You may be surprised but the online help may be live. You can make it a center of an online community. Fair allow your software users to extend your help pages themselves. A good example is PHP online documentation. It allows users to post their comments, code samples, and recommendations. Each page contains large indefinite amount of valuable information contributed by users. This is a perfectible example of how boring documentation may represent a live community and promote the product accordingly.
To tell the above tips: You must consider your manual as an important part of your business model. This is just a set of general recommendations how to get the maximum effect out of your online help. Most of the techniques are pretty easy to implement if you useable good help authoring software. Apply this advice and make your customers feel happy, increase your web site low profile, attract new prospects, and generate new sales.
|
