Documentation for electronic distribution...

Subject: Documentation for electronic distribution...
From: Doug Osborn <doug -at- FEIJOA -dot- CITR -dot- UQ -dot- OZ -dot- AU>
Date: Mon, 12 Jul 1993 18:16:45 GMT

I am writing a paper on "Documentation for electronic distribution", aimed
primarily at in-house software, shareware, and public domain IBM-PC authors.
The aim of the paper is to give non-writers some things to think about
and some guidelines when putting together documentation for their products.

The typical scenario i see is the programmer including some *.doc, *.txt or
*.ps (PostScript), files in the archive that also contains the
program. I am going to write about things like quick start sections,
structuring the document (inlcuding sections like an overview, index, TOC,
etc), appropriate detail and depth, making it easy for the user to "get
into" the product.

Any opinions on the above, more ideas on what should be covered, or things
you would like to see software authors include in their electronically
distributed documentation?

Please forward replies to doug -at- citr -dot- uq -dot- oz -dot- au and i will post a summary if
there is enough interest. Thanks!

Doug Osborn | Centre for Information Technology Research
Technical Writer | Level 6, Gehrmann Laboratories
InterNet: doug -at- citrus -dot- uq -dot- oz -dot- au | The University of Qld, St Lucia
Phone : + 61 7 365 3548 | Qld, Australia 4072. Fax: +61 7 365 4399

Previous by Author: Re: Re[2]: Job Information
Next by Author: doc metrics
Previous by Thread: Answers to Resume Question
Next by Thread: Re: Documentation for electronic distribution...

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

Sponsored Ads