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:Re: Two Questions From:Gerry Bourguignon <GBourgui -at- LAVASYS -dot- COM> Date:Thu, 11 Feb 1999 09:32:53 -0500
1. I am maintaining the documentation for a similar product and am using
RoboHELP Office (which includes HTML Edition and Classic). You can create
and maintain several online Help formats with the RoboHELP HAT.
2. We worked with the print vendor to ensure that our FrameMaker files were
printed correctly. This involved testing a few printer drivers before we
found one that produced the same results on the vendor's Docutech system.
We subsequently generated print files from our FrameMaker books and
delivered them to the print vendor on diskette. As a result, the manuals
that came back from the vendor contained no surprises.
Lone Technical Writer
Open Text Corp, LAVA Div.
Toronto, Ontario, Canada
> -----Original Message-----
> From: Linda Castellani [SMTP:linda -at- GRIC -dot- COM]
> Sent: Wednesday, February 10, 1999 9:08 PM
> To: TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU
> Subject: Two Questions
> 1. I need to think about creating an on-line help system for a product
> that was developed in Java and uses a Web browser interface. I've
> developed Winhelp systems before, but I'm not clear at all about where to
> start with this one. Do I want a Java Help tool or an HTML tool?
> 2. I just got a manual back from the printer who used our Word file to
> produce the document. On one page there is an orphan that I had carefully
> removed from the original by shaving off points before and points after
> paragraphs on the preceding page. I'm not all sure why the orphan came
> back, but what I'm wondering from all of you is, how critical are you in
> reviewing writing samples? If you saw a widow or an orphan in a document,
> would you not consider the candidate? I'm trying to decide whether this
> document goes in my portfolio or not. Am I worrying needlessly?
> Thank you for your insights!