Online-Help Development Resources
This is the online-help development resources page for the online help course. If you know of good resources for people learning to create online helps, contact firstname.lastname@example.org.
Whichever help-authoring tool you use in this course, be sure you learn the essential skills for any such tool.
- MadCap Flare for the Total Newbie: Why Single-sourcing, Multi-channel Publishing is Essential. A nice intro to Flare.
- Online Help Formats. This provides a fairly comprehensive list of some of the major online help formats available and some good general information about each format.
- HAT (Help Authoring Tools) Matrix web site. Good information on some of the vendors that create Help Authoring Tools. This site give you the ability to compare up to 4 tools side-by-side - pretty cool stuff.
- Liability for Defective Documentation. Cem Kaner's important article justifying information testing.
- IconLogin Weblog. Lots of useful information on RoboHelp.
- indoition.com. Quite a collection of "basic know-how, checklists, tools and links, which will help you to write create clear and concise user-friendly manuals."
- RoboWizard. Offers "Gober Guides" for specific areas of RoboHelp HTML.
- WritersUA. From WinWriters, Inc. In particular, see WebResources and Archives.
- Context-sensitive help. One place to start with this difficult topic.
- Introduction to Apple Help Programming Guide. All about Apple Help, the HTML-based system for providing user assistance in Mac OS X.
- Peter Grainge. Very specific recommendations on fixing very specific help problems. See the info on problems with importing Word documents, in particular.
- TECHWR-L. Search on online help. (Be sure and click the www.techwr-l.com button.)
- Writers Write. From Writers Write, Inc. See the links for RoboHelp and WinHelp.
- Microsoft Manual of Style for Technical Publications. Information from WritersUA.com on how to download this file from Microsoft. http://www.writersua.com/msmanualofstyle.htm
- Technical Writing, Help Authoring Tools, Jobs, and More. From Help-Authoring.Info—this one is noteworthy because it has lots of tips and tricks, reviews of help-authoring software, and help-writer blogs to which you may be able to send questions.
- Online Help and Documentation. Resources made available by Keith Soltys.
- News and Reviews. Provided by techwriter.com. Articles reviewing MadCap Flare, RoboHelp 7, and general online-help industry goings-on.
- What's New in Adobe RoboHelp 7?. Review by Rob Houser.
- 2012 WritersUA Skills and Technologies Survey. From WritersUA (WinWriters, Inc.). The world of online help software is chaotic and changes rapidly. This survey
and other resources at the home page are very useful.
- The Future of RoboHelp?. Joe Welinske's observations on the future of RoboHelp.
- helpstuff blog. From helpstuff.com. Try this one if you have a question or problem with the help-authoring tool you are using.
- Developing a Simple Web-Based Tutorial in RoboHelp. Provided by Ron Kurtus
- Designing a Help System. Microsoft's own discussion of process, format, guidelines for creating helps.
- MSHelpWiki. Knowledgebase of Microsoft Help-related information, initially created by the MicrosoftHelpMVPs and maintained by the Help authoring community. An effort to tie together the many Help-related sites on the Web. Try this one if you have a question or problem with the help-authoring tool you are using.
- Free Help Authoring, Manual and Documentation Writing Tools. Over a dozen free help-development tools.
- HATT: Help Authoring Tools & Techniques. A Yahoo Tech Group. Try this one if you have a question or problem with the help-authoring tool you are using.
Information and programs provided by email@example.com.