From: Wietse Venema (no email)
Date: Fri Aug 01 2003 - 18:08:38 EDT
Again, stop bitching and start contributing.
Wietse
Chateauneuf:
> On Fri, 2003-08-01 at 16:06, Wietse Venema wrote:
> > Chateauneuf:
>
> > The Postfix documentation is not for beginners. It requires that
> > people have mastered the art of reading arcane UNIX manual pages,
> > and it requires that people are familiar with basic UNIX concepts
> > such as <filename.
>
> LOL. I do now.
> >
> > If you don't want to make that investment in yourself, then hire
> > a professional, or use a dumbed-down mickey mouse product
>
> Now you are projecting with respect to what I do or don't want.
>
> The flip side goes something like this:
>
> That Unix documentation is generally arcane is not a virtue. Nor should
> that serve as a model for application documentation.
>
> Additionally, while the target audience may be professional that should
> not be cause for the documentation to be unnecessarily complex,
> inconsistent, contradictory, disjointed or insufficiently cross
> referenced.
>
> If you don't want to make that investment in your product then hire a
> professional to do it for you. ;-) You had that one coming (LOL).
>
> Actually, I may volunteer to help out on this front if I have time this
> fall and if you want someone to do that to begin with.
>
>
|
|
|