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

[Werner LEMBERG]

> 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!


    Werner