Documentation links

Vitaly Fedrushkov willy at lukoil.uu.ru
Wed Feb 26 17:30:33 UTC 2003


Good $daytime,

> Date: Mon, 24 Feb 2003 23:33:39 +0000
> From: Gervase Markham <gerv at mozilla.org>
> To: developers at bugzilla.org
> Subject: Re: Documentation links

> I can see there might be a localisation issue here, though. What are the 
> chances of the Bugzilla Guide (or at least the user-facing part) 
> appearing in other languages?

I was looking at my Apache log to tell what to translate first.  Now I
feel that complete and consistent html documentation is not something
very often referred from Bugzilla UI.  But pages explaining bug
lifecycle (bugwritinghelp.html, confirmhelp.html, bug_status.html)
are frequent fliers.

BTW, at bug 182975 I was told that help pages are to be templatised.
Given that documentation is generated from SGML anyway, why not
convert it into templates at build time?  Advantages: 

 o  Multilanguage environment made easy;
 o  Ability to refer to actual site environment (known to TT);
 o  Placement and access control issues (mentioned by David 
    at thread start) go away.

  Regards,
  Willy.

--
No easy hope or lies        | Vitaly "Willy the Pooh" Fedrushkov
Shall bring us to our goal, | Control Systems and Processes Division
But iron sacrifice          | LUKOIL Company, Chelyabinsk Branch
Of Body, Will and Soul.     | willy at lukoil.uu.ru  +7 3512 620367
                  R.Kipling | VVF1-RIPE




More information about the developers mailing list