[Fwd: Online Help]

[Gervase Markham]

Anyone got any views on this? I heard nothing when I sent it originally...

Gerv

-------- Original Message --------
Subject: Online Help
Date: Mon, 30 Sep 2002 21:35:53 +0100
From: Gervase Markham <gerv at mozilla.org>
Reply-To: developers at bugzilla.org
Organization: mozilla.org
To: developers at bugzilla.org

There's a patch for context-sensitive help over in
http://bugzilla.mozilla.org/show_bug.cgi?id=114179 (needs review, if
anyone thinks it's worth having) , but this message is more about things
like the Bug Writing Guidelines.

I produced a patch to make these a page.cgi page (so they got a header,
footer etc.) but matty made the point that this stuff should perhaps be
in our end-user documentation, which is currently Section 3 of the
Bugzilla Guide.

So we need to have a discussion about our strategy. There seem to be a
couple of routes for page-based help:

- page.cgi-based pages.
    Pros: Bugzilla look and feel
    Cons: possible duplication of material with that in the Guide

- 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

Views?

Gerv

----
To view or change your list settings, click here:
<http://bugzilla.org/cgi-bin/mj_wwwusr?user=gerv@mozilla.org>