From: Chateauneuf (no email)
Date: Fri Aug 01 2003 - 16:20:02 EDT
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.
|
|
|