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

Re: Texinfo vs man (was: Re: Debian GNU/Linux Reference Card under construction)

> More information _is_ a problem when you need a quick and terse summary

When it is, it's a good idea, and easy to include a reference card, or
cheat sheet in the (info) documentation.  I'm not convinced that the
best way to provide quick access to documentation in a reference card
or cheat-sheet like manner is to provide different types means of
documentation browsers.

> you will be much better off with walking a bunch of hypertext links
> and we have so much more to say

This is really not what I want to advocate.  Of course quick and easy
access is good.  That's a reason why I think that different possible
sources to hunt for information is not the ideal situation.

The index should bring you where you want to go, that's only one link
away.  It should be quicker than string searching.  If not, I consider
that to be a bug.

> Tutorials have their place; so do reference cards.  Mixing those is
> not a good idea.

Hmm.  I think it would be great if every info document had a top-level
menu node called `Quick reference card'.


Jan Nieuwenhuizen <janneke@gnu.org> | GNU LilyPond - The music typesetter
http://www.xs4all.nl/~jantien       | http://www.lilypond.org

Reply to: