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:Using Domino to Publish Documentation on Internet From:Solveig Haugland <Solveig_Haugland -dot- GPS -at- GPS -dot- COM> Date:Wed, 21 Aug 1996 10:40:32 EDT
I'm documenting an Internet commerce product and all documentation will be in
HTML. I've figured out a decent system that I'll use. However, I've been asked
to consider putting all the documentation in Notes and publishing it as web
documents using Domino.
This strikes me as something that is more "cool" than actually useful, since
the documentation won't contain any complex forms and will simply be the usual
text, tables and illustrations. However, I'm willing (slightly grudgingly, I
admit) to consider it. I have a few questions, naturally:
A) Has anyone else done this?
B) Is this going to be better than my current system, which is to
- just compose in Word, using styles that correspond to HTML styles
- which I convert very easily to HTML using FrontPage or HTML Transit?
- (I can use Transit to automatically create a linked TOC for the whole manual
and for each chapter, too, though actually purchasing a copy rather than using
an evaluation copy would be $500.)
The conversion process for a 100-page manual strikes me as maybe a half hour,
including a little tweaking afterwards.
C) Does Domino give me a nice, tangible .HTM file that I can pick up and take
with me, or does it just publish invisibly without creating an .HTM file and
will that cause problems?
D) Can I edit the Internet-published output from Domino in HTML if I want to
[new title at work still in the works]
Most High and Mighty Mistress of RTFM--D.N.R.C.
shauglan -at- gps -dot- com
TECHWR-L List Information
To send a message about technical communication to 2500+ list readers,
E-mail to TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU -dot- Send administrative commands
ALL other questions or problems concerning the list
should go to the listowner, Eric Ray, at ejray -at- ionet -dot- net -dot-