Cross-platform on-line documentation

Subject: Cross-platform on-line documentation
From: Andrew Gilling <andy -at- DIRCON -dot- CO -dot- UK>
Date: Sun, 1 Sep 1996 23:08:13 +0100

Can anybody suggest how I might go about producing on-line documentation for
both Windows programmers and Macintosh programmers, preferably from a single
source? What needs documenting is a large body of C++ code at a multimedia
publishing company that produces titles for both platforms. The application
of origin would be Word for Windows.

My boss wants Windows Help for the Windows people, so that they can summon
it up from within their development tool, MSVC, and is asking whether Help
files could not simply be converted to HTML for the Macintosh people. So one
question is, do you know if this could be done? But I am sceptical about the
idea if it would mean an inferior provision for the Macintosh people. I
wonder whether features like TOC's and searchable indexes would be lost in
the Help-to-HTML conversion, and whether I would then be able to add them to
the HTML output; which is the second question.

What the Macintosh programmers would really prefer is something like Windows
Help but for the Macintosh, ideally something like ThinkReference, which
they too could open from within their development tool, CodeWarrior.

Guidance would be very welcome.

Andrew Gilling (newish technical writer, but not desperately technical)

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-

Previous by Author: online help estimates
Next by Author: Best of Breed
Previous by Thread: Info Mapping-Windows NT Server
Next by Thread: Cross-platform on-line documentation

What this post helpful? Share it with friends and colleagues:

Sponsored Ads