TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
Subject:Learning to index my own project From:"Jennifer C. Bennett" <fritillary -at- gmail -dot- com> To:<techwr-l -at- lists -dot- techwr-l -dot- com> Date:Wed, 10 Dec 2008 12:33:49 -0600
Hello,
I am a technical writer working in the software industry. I've been working
on a large RoboHelp 7 Web Help project. I really need to create an index
for this project - but I want to go about it the right way, and I'm not sure
where to begin. I don't trust the RoboHelp "Smart Index" feature for
creating an index. It might be more useful for a smaller project. Since
the project is so large, I am tending to think that the index should be well
thought out, rather than relying on an automated system.
I've looked up a couple books on Amazon - does anyone have any insight as to
whether these books would be useful for someone who is indexing her own
WebHelp projects? My goal is simply to make the information in the WebHelp
project (which is also compiled into DOC and PDF files) as easy as possible
for my users to locate.
* Can I create an excellent index from scratch using "Indexes: A Chapter
from the Chicago Manual of Style"? (nice price!)
Or should I purchase a book that is more in-depth on the subject - or would
that be overkill? The books I've been looking at include:
* "Indexing Books" by Nancy C. Mulvany (As mentioned in the title, this
book is for indexing *books* - does the information translate to indexing
for WebHelp?)
* "The Indexing Companion" by Glenda Browne and Jon Jermey
ComponentOne Doc-To-Help 2009 is your all-in-one authoring and publishing
solution. Author in Doc-To-Help's XML-based editor, Microsoft Word or
HTML and publish to the Web, Help systems or printed manuals. http://www.doctohelp.com
Help & Manual 5: The complete help authoring tool for individual
authors and teams. Professional power, intuitive interface. Write
once, publish to 8 formats. Multi-user authoring and version control! http://www.helpandmanual.com/
---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-