On Tue, 2005-08-16 at 16:18, Bryan J. Smith wrote:
> Most people are like this, task-oriented. The "Samba 3 by
> Example" book has been outstanding in this regard. But there
> is still the "Samba 3 HOWTO Collection" for those that want
> more of a "manual."
Technical books and manuals should nearly always be written in
2 parts. One part should be a tutorial which shows step by step
how to do something and gives an overview of the concepts. You'll
go through that part once and never want to see it again. The
2nd part, preferably in a separate physical volume, should be
the reference manual where you will look for the gory details
after you know the basics and want to fine-tune something. Unix
'man' pages are the style you want for reference, but first
you need to know what programs are involved, what the shell is
going to do with what you type, and some other things that a
tutorial approach gives. Usually you don't want both of those
things at the same time.
--
Les Mikesell
lesmikesell at gmail.com