Re: Advice required

[Meg Halter <aiki4us -at- yahoo -dot- com>]

Hi Naomi --

I'm in a similar situation. My solution has been to use
plain-vanilla HTML pages. Since we have lots and lots of legacy
paper documents, link those in using Adobe Acrobat. The emphasis
has been content over aesthetics. While the result is crude, it
can be viewed on any platform and the users don't need special
software to view it. Initially I used Netscape composer, which
yields ugly HTML code. Since then, I've used mostly Notepad (on
Windows) or nedit (on IRIX). W3C has a tool called HTMLTidy,
which will clean up HTML code (which improves portability). I'd
like to add an index one of these days, but that's a low
priority.

I'm not terribly happy with using Notepad to write the HTML
because I suspect I've consumed time that more sophisticated
development software would have saved. Further, we will be
spawing off another version of the software, so multiple
versions of the docs will be needed shortly. This will cause
maintenance problems for duplicate information that must be kept
in synch. I'm still researching options for dealing with this.

Hope this helps. Good luck.

-- Meg
------------------------------------------
Naomi (Stevens) writes:

I've been offered a contract to produce on-line documentation
for an application designed to work on multiple platforms. 
(Currently works on PC, Mac and Unix although development is
underway for others.)  A single set of files is required which
will run on all browsers without the need to use Java.

May I please have advice on which writing tool would be the most
effective to produce the documentation for this application?

__________________________________________________
Do You Yahoo!?
Get email alerts & NEW webcam video instant messaging with Yahoo! Messenger
http://im.yahoo.com

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

A landmark hotel, one of America's most beautiful cities, and 
three and a half days of immersion in the state of the art:
IPCC 01, Oct. 24-27 in Santa Fe.  http://ieeepcs.org/2001/

  +++  Miramo -- Database/XML publishing automation.  See us at  +++
  +++  Seybold SFO, Sept. 25-27, in the Adobe Partners Pavilion  +++
  +++ More info: http://www.axialinfo.com  http://www.miramo.com +++

---
You are currently subscribed to techwr-l as: archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot-  Visit 
http://www.raycomm.com/techwhirl/ for more resources and info.