[Fwd: Online Help]

Matthew P. Barnson matthew at barnson.org
Tue Nov 5 01:59:51 UTC 2002


On Mon, 2002-11-04 at 10:43, Gervase Markham wrote:
> Anyone got any views on this? I heard nothing when I sent it originally...
> - page.cgi-based pages.
>     Pros: Bugzilla look and feel
>     Cons: possible duplication of material with that in the Guide

  I'd be against this sort of approach... duplication of effort is
needless.

> - link directly to pages in the Guide
>     Pros: One source for Bugzilla usage information
>     Cons: Possible that manual and online help require different styles
>           Harder to translate

  I'd be all for this kind of approach.  The important thing is to
figure out the context-sensitive portions that the Guide could have
links for.  Hmm, that didn't come out well.  I mean, KDE and Gnome both
use this type of help system, where in the well-written products,
clicking "help" at a particular part takes you to the help screen for
the menu/dropdown/what-have-you that you're at.  You can also read the
help end-to-end.  It would require a bit more of a screen-based approach
to the User's Guide portion of The Bugzilla Guide, but would be quite
do-able IMHO, and probably more readable than what we have now.

 
-- 
Matthew P. Barnson
Sr. UNIX Systems Administrator
DAM Computer Consulting, Inc.
"When you cuss, think of us!"

"...the general idea that [the Supreme Court ]will restrain
itself, despite believing a law is stupid, is a feature,
not a bug in our constitutional tradition."
-Lawrence Lessig
nd 100%". --Penn Jillette
 one and drive on without guilt!
-ccm





More information about the developers mailing list