From: Peter H. Coffin (no email)
Date: Sat Aug 02 2003 - 00:25:49 EDT
On Fri, Aug 01, 2003 at 02:33:30PM -0700, Bryan Koschmann - GKT wrote:
> > I think this particular example relates to the intended audience and
> > type of the documentation. Wietse's manpages are reference-style
> > intended for people familiar (and content) with putting the pieces
> > together themself. Tips like "start simple, then build on that
> > foundation" belong not in reference pages but in tutorial-style books
> > or howtos.
>
>
> I don't consider it a tip. I was thinking more along the lines of:
>
> "When configuring Postfix for MySQL, use the virtual maps in the manpage,
> replacing each with the proper MySQL syntax, as shown in this example"
>
> That one line would have saved me a lot of pain and frustration. If by
> chance I missed it, I would be happy to know where.
*shrug* Reading it from the perspective of someone who's run Postfix for
a while, such a line seems intuitively obvious, almost to the point of
redundency. Of *course* postfix needs back something that looks like
what it would get back from a similar lookup into another sort of data
source....
--
11. I will be secure in my superiority. Therefore, I will feel no need to prove
it by leaving clues in the form of riddles or leaving my weaker enemies
alive to show they pose no threat.
--Peter Anspach's list of things to do as an Evil Overlord
|
|
|