From eb50b5abb6bc14f705c4794b34c7c573739afd40 Mon Sep 17 00:00:00 2001 From: "jake%bugzilla.org" <> Date: Fri, 4 Apr 2008 11:47:17 +0000 Subject: Update links to tldp.org and Bugzilla version numbers. Also, added some text ab out this being a development version of the guide and instructions on what to ch ange for a release (including how to disable the devel text). --- docs/en/xml/Bugzilla-Guide.xml | 33 +++++++++-- docs/en/xml/about.xml | 130 +++++++++++++++-------------------------- 2 files changed, 74 insertions(+), 89 deletions(-) (limited to 'docs/en') diff --git a/docs/en/xml/Bugzilla-Guide.xml b/docs/en/xml/Bugzilla-Guide.xml index 015aed327..a76d2c090 100644 --- a/docs/en/xml/Bugzilla-Guide.xml +++ b/docs/en/xml/Bugzilla-Guide.xml @@ -19,12 +19,25 @@ + + + + + + + - - - - - Bugzilla"> @@ -63,7 +76,7 @@ The warning, "DTDDECL catalog types not supported" is normal. * Try to index important terms wherever possible. * Use "glossterm" whenever you introduce a new term. -* Follow coding standards at http://www.linuxdoc.org, and +* Follow coding standards at http://www.tldp.org, and check out the KDE guidelines (they are nice, too) http://i18n.kde.org/doc/markup.html * All tags should be lowercase (needsfix) @@ -94,6 +107,8 @@ try to avoid clutter and feel free to waste space in the code to make it more re + &bz-date; + This is the documentation for Bugzilla, the mozilla.org @@ -109,6 +124,12 @@ try to avoid clutter and feel free to waste space in the code to make it more re to a bug filed in mozilla.org's Bugzilla. + This is a development version of this guide. Information in it + is subject to change before the &bz-nextver; release of this guide + (which will correspond with the &bz-nextver; release of Bugzilla). + + ]]> diff --git a/docs/en/xml/about.xml b/docs/en/xml/about.xml index 62e486573..219d529e1 100644 --- a/docs/en/xml/about.xml +++ b/docs/en/xml/about.xml @@ -4,40 +4,6 @@ About This Guide -
- Purpose and Scope of this Guide - - Bugzilla is simply the best piece of bug-tracking software the - world has ever seen. This document is intended to be the - comprehensive guide to the installation, administration, - maintenance, and use of the Bugzilla bug-tracking system. - - - This release of the Bugzilla Guide is the - &bzg-ver; release. It is so named that it - may match the current version of Bugzilla. The numbering - tradition stems from that used for many free software projects, - in which even-numbered point releases (1.2, - 1.14, etc.) are considered "stable releases", intended for - public consumption; on the other hand, - odd-numbered point releases (1.3, 2.09, - etc.) are considered unstable development - releases intended for advanced users, systems administrators, - developers, and those who enjoy a lot of pain. - - - Newer revisions of the Bugzilla Guide follow the numbering - conventions of the main-tree Bugzilla releases, available at - &bz;. Intermediate releases will have - a minor revision number following a period. The current version - of Bugzilla, as of this writing (&bzg-date;) is &bz-ver;; if - something were seriously wrong with that edition of the Guide, - subsequent releases would receive an additional dotted-decimal - digit to indicate the update (&bzg-ver;.1, &bzg-ver;.2, etc.). - Got it? Good. - -
-
@@ -64,12 +34,11 @@ No liability for the contents of this document can be accepted. Use the concepts, examples, and other content at your own risk. - As this is a new edition of this document, there may be errors - and inaccuracies that may damage your system. Use of this - document may cause your girlfriend to leave you, your cats to - pee on your furniture and clothing, your computer to cease - functioning, your boss to fire you, and global thermonuclear - war. Proceed with caution. + This document may contain errors + and inaccuracies that may damage your system, cause your partner + to leave you, your boss to fire you, your cats to + pee on your furniture and clothing, and global thermonuclear + war. Proceed with caution. All copyrights are held by their respective owners, unless @@ -100,7 +69,7 @@ team members, Netscape Communications, America Online Inc., and any affiliated developers or sponsors assume no liability for your use of this product. You have the source code to this - product, and are responsible for auditing it yourself to insure + product, and are responsible for auditing it yourself to ensure your security needs are met.
@@ -110,33 +79,39 @@
New Versions - This is the &bzg-ver; version of The Bugzilla Guide. If you are + This is the &bz-ver; version of The Bugzilla Guide. It is so named + to match the current version of Bugzilla. + + If you are reading this from any source other than those below, please check one of these mirrors to make sure you are reading an up-to-date version of the Guide. - This document can be found in the following places: + The newest version of this guide can always be found at bugzilla.org; including + documentation for past releases and the current development version. - - - - bugzilla.org - - - - - The Linux - Documentation Project - - - + The documentation for the most recent stable release of Bugzilla can also + be found at + The Linux Documentation Project. - The latest version of this document can be checked out via CVS. - Please follow the instructions available at the Mozilla CVS page, and check out the mozilla/webtools/bugzilla/docs/ branch. + The latest version of this document can always be checked out via CVS. + Please follow the instructions available at + the Mozilla CVS page, + and check out the mozilla/webtools/bugzilla/docs/ + subtree. + + + The Bugzilla Guide is currently only available in English. + If you would like to volunteer to translate it, please contact + Dave Miller.
@@ -144,13 +119,14 @@ Credits The people listed below have made enormous contributions to the - creation of this Guide, through their dedicated hacking efforts, + creation of this Guide, through their writing, dedicated hacking efforts, numerous e-mail and IRC support sessions, and overall excellent contribution to the Bugzilla community: Matthew P. Barnson - for pulling together the Bugzilla Guide and shepherding it to 2.14. + for the Herculaean task of pulling together the Bugzilla Guide and + shepherding it to 2.14. Terry Weissman @@ -158,13 +134,13 @@ README upon which the UNIX installation documentation is largely based. - Tara - Hernandez for keeping Bugzilla development going - strong after Terry left Mozilla.org + Tara Hernandez + for keeping Bugzilla development going + strong after Terry left mozilla.org - Dave Lawrence for - providing insight into the key differences between Red Hat's + Dave Lawrence + for providing insight into the key differences between Red Hat's customized Bugzilla, and being largely responsible for the "Red Hat Bugzilla" appendix @@ -174,8 +150,8 @@ questions and arguments on irc.mozilla.org in #mozwebtools - Last but not least, all the members of the netscape.public.mozilla.webtools newsgroup. Without your discussions, insight, suggestions, and patches, this could never have happened. + Last but not least, all the members of the + netscape.public.mozilla.webtools newsgroup. Without your discussions, insight, suggestions, and patches, this could never have happened. Thanks also go to the following people for significant contributions @@ -183,19 +159,7 @@ Zach Liption, Andrew Pearson, Spencer Smith, Eric Hanson, Kevin Brannen, - Ron Teitelbaum, Jacob Steenhagen, Joe Robins. - - - -
- Translations - - The Bugzilla Guide needs translators! Please volunteer your - translation into the language of your choice. If you will - translate this Guide, please notify the members of the - mozilla-webtools mailing list at - mozilla-webtools@mozilla.org, and arrange with - &bzg-auth; to check it into CVS. + Ron Teitelbaum, Jacob Steenhagen, Joe Robins, Gervase Markham.
-- cgit v1.2.3-24-g4f1b