Re: Trends in documentation delivery?

["Simon Coulter" <shc@xxxxxxxxxxxxxxxxx>]

Hello David,

Much as I dislike MS they do have quite a good manual about creating 
documentation.  It is called The 
Microsoft Manual of Style for Technical Publications and is published by 
Microsoft Press.  You can probably 
order it through Amazon (order it via midrange.com and you'll probably get an 
extra discount -- ha, ha).

Another thing,  I have seen the various appends complaining about the softcopy 
manuals.  I don't really 
understand the complaints.  I use the softcopy CD all the time and while there 
are occasions when I would 
prefer a paper manual (API reference, etc) it works really well once you get 
used to the grouping in the 
bookshelves.

The only difficulty I can see with the softcopy CD is when you have to use the 
Library Reader for Windows 
which would have to be one of the all-time awful peices of software.  The OS/2 
version is so much easier to 
use.

What is it people dislike about the softcopy?

I can't believe HTML is a better choice because it generally has poor 
searching, poor indexing, poor table of 
contents, and poor printing support -- all of it is pretty bad.

Why do people think HTML is better?

Regards,
Simon Coulter.

//----------------------------------------------------------
// FlyByNight Software         AS/400 Technical Specialists
// Phone: +61 3 9419 0175      Mobile: +61 0411 091 400
// Fax:   +61 3 9419 0175      E-mail: shc@flybynight.com.au
// 
// Windoze should not be open at Warp speed.

+---
| This is the Midrange System Mailing List!
| To submit a new message, send your mail to MIDRANGE-L@midrange.com.
| To subscribe to this list send email to MIDRANGE-L-SUB@midrange.com.
| To unsubscribe from this list send email to MIDRANGE-L-UNSUB@midrange.com.
| Questions should be directed to the list owner/operator: david@midrange.com
+---