diff options
Diffstat (limited to 'docs/sgml/about.sgml')
| -rw-r--r-- | docs/sgml/about.sgml | 104 |
1 files changed, 35 insertions, 69 deletions
diff --git a/docs/sgml/about.sgml b/docs/sgml/about.sgml index 62e486573..b4349644a 100644 --- a/docs/sgml/about.sgml +++ b/docs/sgml/about.sgml @@ -4,40 +4,6 @@ <chapter id="about"> <title>About This Guide</title> - <section id="aboutthisguide"> - <title>Purpose and Scope of this Guide</title> - <para> - 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. - </para> - <para> - This release of the Bugzilla Guide is the - <emphasis>&bzg-ver;</emphasis> 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 <emphasis>even-numbered</emphasis> point releases (1.2, - 1.14, etc.) are considered "stable releases", intended for - public consumption; on the other hand, - <emphasis>odd-numbered</emphasis> point releases (1.3, 2.09, - etc.) are considered unstable <emphasis>development</emphasis> - releases intended for advanced users, systems administrators, - developers, and those who enjoy a lot of pain. - </para> - <para> - Newer revisions of the Bugzilla Guide follow the numbering - conventions of the main-tree Bugzilla releases, available at - <ulink url="&bz;">&bz;</ulink>. 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. - </para> - </section> - <section id="copyright"> <title>Copyright Information</title> <blockquote> @@ -48,8 +14,7 @@ License, Version 1.1 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and with no Back-Cover Texts. A copy of - the license is included in the section entitled "GNU Free - Documentation License". + the license is included below. </para> </blockquote> <para> @@ -57,6 +22,11 @@ copyright, or publishing this document in non-electronic form, please contact &bzg-auth;. </para> + + + <!-- The GNU Free Documentation License --> + &gfdl; + </section> <section id="disclaimer"> @@ -64,12 +34,11 @@ <para> 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. </para> <para> 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. </para> </section> @@ -110,7 +79,8 @@ <section id="newversions"> <title>New Versions</title> <para> - This is the &bzg-ver; version of The Bugzilla Guide. If you are + This is the &bzg-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. @@ -134,9 +104,16 @@ </itemizedlist> </para> <para> - The latest version of this document can be checked out via CVS. - Please follow the instructions available at <ulink - url="http://www.mozilla.org/cvs.html">the Mozilla CVS page</ulink>, and check out the <filename>mozilla/webtools/bugzilla/docs/</filename> branch. + The latest version of this document can always be checked out via CVS. + Please follow the instructions available at + <ulink url="http://www.mozilla.org/cvs.html">the Mozilla CVS page</ulink>, + and check out the <filename>mozilla/webtools/bugzilla/docs/</filename> + subtree. + </para> + <para> + The Bugzilla Guide is currently only available in English. + If you would like to volunteer to translate it, please contact + <ulink url="mailto:justdave@syndicomm.com">Dave Miller</ulink>. </para> </section> @@ -144,13 +121,14 @@ <title>Credits</title> <para> 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: </para> <para> <ulink url="mailto://mbarnson@sisna.com">Matthew P. Barnson</ulink> - 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. </para> <para> <ulink url="mailto://terry@mozilla.org">Terry Weissman</ulink> @@ -158,13 +136,13 @@ README upon which the UNIX installation documentation is largely based. </para> <para> - <ulink url="mailto://tara@tequilarista.org">Tara - Hernandez</ulink> for keeping Bugzilla development going - strong after Terry left Mozilla.org + <ulink url="mailto://tara@tequilarista.org">Tara Hernandez</ulink> + for keeping Bugzilla development going + strong after Terry left mozilla.org </para> <para> - <ulink url="mailto://dkl@redhat.com">Dave Lawrence</ulink> for - providing insight into the key differences between Red Hat's + <ulink url="mailto://dkl@redhat.com">Dave Lawrence</ulink> + for providing insight into the key differences between Red Hat's customized Bugzilla, and being largely responsible for the "Red Hat Bugzilla" appendix </para> @@ -174,8 +152,8 @@ questions and arguments on irc.mozilla.org in #mozwebtools </para> <para> - Last but not least, all the members of the <ulink - url="news://news.mozilla.org/netscape/public/mozilla/webtools"> netscape.public.mozilla.webtools</ulink> newsgroup. Without your discussions, insight, suggestions, and patches, this could never have happened. + Last but not least, all the members of the + <ulink url="news://news.mozilla.org/netscape/public/mozilla/webtools"> netscape.public.mozilla.webtools</ulink> newsgroup. Without your discussions, insight, suggestions, and patches, this could never have happened. </para> <para> Thanks also go to the following people for significant contributions @@ -183,19 +161,7 @@ </para> <para> Zach Liption, Andrew Pearson, Spencer Smith, Eric Hanson, Kevin Brannen, - Ron Teitelbaum, Jacob Steenhagen, Joe Robins. - </para> - </section> - - <section id="translations"> - <title>Translations</title> - <para> - 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 - <email>mozilla-webtools@mozilla.org</email>, and arrange with - &bzg-auth; to check it into CVS. + Ron Teitelbaum, Jacob Steenhagen, Joe Robins, Gervase Markham. </para> </section> |