On Sunday 21 Sep 2003 7:37 pm, David Filion wrote:
Richard Urwin wrote:
On Sunday 21 Sep 2003 3:22 pm, Aron Smith wrote:
** The one thing that Programmers are NOT good at is Documentation. That's why Tech Writers exist (unfortunately the good ones find out that writing Science Fiction pays better :-( ).
As a programmer:
Documenting a program is a good and worthwhile activity; like going to the dentist. However documentation is like sex; when it's good it's wonderful, and when it's bad it's still better than nothing.
man pages are not meant to be a hand holding how-to document (though recently, some apps are using them as such). If you want to know how to use a command/app, read a how-to, do a google from a tutorial, don't read the man page. man pages are meant to refresh you memory about a command's function and it's options.
which is where they are great. So please, don't tell newbies that they are the first port of call.
Anne
Amen to that.
-- David Filion
Want to buy your Pack or Services from MandrakeSoft? Go to http://www.mandrakestore.com
