From ce0bcb51292273121588daed6316c8200006bd4f Mon Sep 17 00:00:00 2001 From: "gerv%gerv.net" <> Date: Fri, 4 Apr 2008 11:47:12 +0000 Subject: General updates. I'm working through the entire guide, tidying it up. --- docs/en/xml/about.xml | 237 +++++++++++++++++++++++++++++++------------------- 1 file changed, 146 insertions(+), 91 deletions(-) (limited to 'docs/en/xml/about.xml') diff --git a/docs/en/xml/about.xml b/docs/en/xml/about.xml index b594ce163..62e486573 100644 --- a/docs/en/xml/about.xml +++ b/docs/en/xml/about.xml @@ -1,29 +1,61 @@ + ] > --> 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. + +
+ @@ -31,28 +63,44 @@ Disclaimer No liability for the contents of this document can be accepted. - Follow the instructions herein at your own risk. - 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. + 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. + + + All copyrights are held by their respective owners, unless + specifically noted otherwise. Use of a term in this document + should not be regarded as affecting the validity of any + trademark or service mark. Naming of particular products or brands should not be seen as - endorsements, with the exception of the term "GNU/Linux". We - wholeheartedly endorse the use of GNU/Linux; it is an extremely - versatile, stable, + endorsements, with the exception of the term "GNU/Linux". We + wholeheartedly endorse the use of GNU/Linux in every situation + where it is appropriate. It is an extremely versatile, stable, and robust operating system that offers an ideal operating environment for Bugzilla. + + You are strongly recommended to make a backup of your system + before installing Bugzilla and at regular intervals thereafter. + If you implement any suggestion in this Guide, implement this one! + Although the Bugzilla development team has taken great care to - ensure that all exploitable bugs have been fixed, security holes surely - exist in any piece of code. Great care should be taken both in - the installation and usage of this software. The Bugzilla development - team members assume no liability for your use of Bugzilla. You have - the source code, and are responsible for auditing it yourself to ensure + ensure that all easily-exploitable bugs or options are + documented or fixed in the code, security holes surely exist. + Great care should be taken both in the installation and usage of + this software. Carefully consider the implications of installing + other network services with Bugzilla. The Bugzilla development + 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 your security needs are met. @@ -62,46 +110,33 @@
New Versions - This is the &bz-ver; version of The Bugzilla Guide. It is so named - to match the current version of Bugzilla. - - - - The latest version of this guide can always be found at , or checked out via CVS by - following the Mozilla - CVS instructions and check out the - mozilla/webtools/bugzilla/docs/ - subtree. However, you should read the version - which came with the Bugzilla release you are using. - - - The Bugzilla Guide, or a section of it, is also available in - the following languages: - German. - - - - In addition, there are Bugzilla template localisation projects in - the following languages. They may have translated documentation - available: - Belarusian, - Brazilian Portuguese, - Chinese, - French, - German, - Korean, - Russian and - Spanish. - - - - If you would like to volunteer to translate the Guide into additional - languages, please contact - Dave Miller. + This is the &bzg-ver; version of The Bugzilla Guide. 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: + + + + + + bugzilla.org + + + + + 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.
@@ -109,38 +144,58 @@ Credits The people listed below have made enormous contributions to the - creation of this Guide, through their writing, dedicated hacking efforts, + creation of this Guide, through their 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. + + + Terry Weissman + for initially writing Bugzilla and creating the + README upon which the UNIX installation documentation is largely based. + + + 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 + customized Bugzilla, and being largely responsible for the "Red + Hat Bugzilla" appendix + + + Dawn Endico for + being a hacker extraordinaire and putting up with my incessant + 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. + + + Thanks also go to the following people for significant contributions + to this documentation (in no particular order): + + + Zach Liption, Andrew Pearson, Spencer Smith, Eric Hanson, Kevin Brannen, + Ron Teitelbaum, Jacob Steenhagen, Joe Robins. + + +
+ Translations - - Matthew P. Barnson - Kevin Brannen - Dawn Endico - Ben FrantzDale - Eric Hanson - Tara Hernandez - Dave Lawrence - Zach Lipton - Gervase Markham - Andrew Pearson - Joe Robins - Spencer Smith - Jacob Steenhagen - Ron Teitelbaum - Terry Weissman - Martin Wulffeld - . - - - - Also, thanks are due to the members of the - - netscape.public.mozilla.webtools - newsgroup. Without your discussions, insight, suggestions, and patches, - this could never have happened. + 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.
@@ -163,7 +218,7 @@ sgml-local-ecat-files:nil sgml-minimize-attributes:nil sgml-namecase-general:t sgml-omittag:t -sgml-parent-document:("Bugzilla-Guide.xml" "book" "chapter") +sgml-parent-document:("Bugzilla-Guide.sgml" "book" "chapter") sgml-shorttag:t sgml-tag-region-if-active:t End: --> -- cgit v1.2.3-24-g4f1b