Like Steve, I've used multiple qmail documentation pages to get Q up and
running and then tweak it to "do the right thing" to suit local
requirements, but unlike Steve I found myself going back to the LWQ document
more times than the others (it's the closest thing I've found to a
one-stop-shop document covering many of the pieces with qmail). Overall, I
have to give kudos to LWQ over some of the other documents, but it still
would be nice to have a goal-oriented set of documents somewhere that
focused on how to meet specific requirements, as opposed to a general
purpose checklist.
Creating good documentation is a challenge.
There are two types of docs in the world:
general-purpose/overview/explain-it-all, and quick-how-to.
Both have their place in the world. The evolution of computer books can be
used as a quick example: In the beginning we had textbook-style tomes that
tried to master every detail, but today we also see the popularity of the
"quick and dirty" books (blank-in-24hrs, dummies, etc.). Both have their
place in the world, but this second type is the more common among the "want
to get things done" crowd versus the "how does it work" crowd.
Personally, I'd love to see a couple documents that were very straight
forward "do this for that" covering the following topics: Q and Virtual
Hosting in an ISP environment, Q and stopping SPAM, Q and Security, and
finally, Q and Performance - monitoring and management.
Same with the different install methodologies. I'd love to see a features
checklist form that you press submit and it spews back links to the required
documentation... Anybody working on a Q knowledge base?
-----Original Message-----
From: Dave Sill [mailto:[EMAIL PROTECTED]]
Sent: Wednesday, November 17, 1999 1:37 PM
To: [EMAIL PROTECTED]; [EMAIL PROTECTED]
Subject: RE: [ Documentation problems ] - just a quick note from me..
"Steve Kapinos" <[EMAIL PROTECTED]> wrote:
>I wouldn't say LWQ is lacking, but the variations between the 'howto'
>documents is wildly different. I think possibly a 'goal tree' might be
>appropriate. IE if you are installing qmail to:
>
>a) install a local only mailsystem with smtp relaying .. then read A
>b) install a small local and pop3 mailserver with smtp relaying .. then
read
>B
>c) install a large pop3 mailserver, with large groups of virtualdomains..
>then read C
The LWQ installation is an appropriate base for all of these
applications.
My intent was to provide the details for a robust and powerful, but
basic, qmail installation in Section 2, and cover stuff like POP and
virtual domains under Section 3--with pointers to existing documents
that cover things well enough already.
...
