[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [Groff] Effective manpages, a couple of thoughts

From: Werner LEMBERG
Subject: Re: [Groff] Effective manpages, a couple of thoughts
Date: Wed, 12 May 2004 10:38:27 +0200 (CEST)

> It became very painfully apparent to me from those experiences that
> a good manual/manpage writer, just like a good online-help designer
> and creator, is a teacher and you can't teach what you don't
> thoroughly understand.  Unfortunately, a lot of good software
> creators aren't good writers in the sense of documenting in terms of
> what the user needs to know from a user perspective.

I fully agree.  The same is true for me: In most cases, the features I
program or add are not optimally described by myself because of the
reasons you outline.  It would be great if you all could help to
improve groff's documentation!


reply via email to

[Prev in Thread] Current Thread [Next in Thread]