Re: swarm docs: minor problem. PS?

[John Eikenberry [MSAI]]

On Mon, 3 Feb 1997, glen e. p. ropella wrote:

> Anyway, it's the big picture that's keeping me from doing it
> (how does one organize a good user's manual?) ... and, I guess,
> the lack of time might have something to do with it.  Do you 
> (or anybody else) have any strong opinions on user manual 
> organization?  For instance, are the O'Reilly styles good?
> Do you go for the "XYZ Unleashed" style?  Or the "XYZ for
> Dummies" style?  Should it read like prose or like a tutorial?

I personally prefer the O'Reilly "? in a Nutshell" format. With a few
chapters of introductory material and then the bulk of the book being a
reference manual. 

John Eikenberry
address@hidden
______________________________________________________________
"A society that will trade a little liberty for a little order
 will deserve neither and lose both."
                                         --B. Franklin