Help Guide Feedback - Was: Etiquette Guide
Aaron Matteson
fedora-docs at cryptosystem.us
Mon Mar 29 07:45:32 UTC 2004
Joshua Daniel Franklin became daring and sent these 1.6K bytes,
> --- Mike MacCana <mikem at cyber.com.au> wrote:
> > On Sat, 27 Mar 2004, Aaron Matteson wrote:
> >
> > > What i am posting about it a request for feedback on what i have done so
> > > far, i would hate to complete it and realize that i did it wrong.
> > > Pointers would also be gratefully accepted.
> >
> > * A thought: maybe replace 'man' with 'info'. Info documentation is often
> > better maintained than man pages, and if you type 'info' and there's no
> > info page, it'll fall back to using the man page - so users get the best
> > available.
>
> I actually wrote a short article covering the differences between
> the two a while ago:
>
> <http://iocc.com/~joshua/misc/maninfo.html>
>
> You have full permission to take anything useful from there, verbatim
> or otherwise. I'd also recommend 'pinfo' over the standalone 'info'
> reader. I actually think 'man' would have disappeared by now if 'info' was
> at all intuitive to use (and all programs had good --help output
> for quick checking). If you encourage people to use 'info' they'll either
> give up or eventually find 'pinfo'.
Thanks :)
> > * I'd mention /usr/share/doc/<packagename>-<version>/ as part of
> > your 'Developer Documentation' section.
>
> Big plus for this one, too.
>
> Also, why not link to ESR's "Smart Questions" itself with ulink?
Had meant to go back and do that but the intention flew the coop.
> There are some minor grammatical issues (like captitalizing "I")
> that I assume you're already planning on fixing. :)
Didn't catch that, thanks :)
--
0 1 0 Aaron M Matteson - GnuPG:0xD144B7FF
0 0 1 Real programmers don't document. If it was hard to write,
1 1 1 it should be hard to understand!
------------------------------------------------------------------------
http://cryptosystem.us/ - Project
http://cryptosystem.us/blog/ - Blog
http://mindstorm.ath.cx:8080/ - Wiki
More information about the fedora-docs-list
mailing list