diff options
Diffstat (limited to 'docs/en/xml/about.xml')
-rw-r--r-- | docs/en/xml/about.xml | 237 |
1 files changed, 146 insertions, 91 deletions
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 @@ <!-- <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [ -<!ENTITY conventions SYSTEM "conventions.xml"> ] > --> +<!ENTITY conventions SYSTEM "conventions.sgml"> ] > --> <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> - - <para>This document is copyright (c) 2000-2004 by the various - Bugzilla contributors who wrote it.</para> - <blockquote> + <attribution>Copyright (c) 2000-2002 Matthew P. Barnson and &bzg-auth;</attribution> <para> Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation - License, Version 1.1 or any later version published by the + 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 <xref linkend="gfdl"/>. + Front-Cover Texts, and with no Back-Cover Texts. A copy of + the license is included in the section entitled "GNU Free + Documentation License". </para> </blockquote> <para> If you have any questions regarding this document, its copyright, or publishing this document in non-electronic form, - please contact the Bugzilla Team. + please contact &bzg-auth;. </para> </section> @@ -31,28 +63,44 @@ <title>Disclaimer</title> <para> 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. + </para> + <para> + 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. </para> <para> 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. </para> <para> + 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! + </para> + <para> 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. </para> </section> @@ -62,46 +110,33 @@ <section id="newversions"> <title>New Versions</title> <para> - This is the &bz-ver; version of The Bugzilla Guide. It is so named - to match the current version of Bugzilla. - <![%bz-devel;[ - This version of the guide, like its associated Bugzilla version, is a - development version. - ]]> - </para> - <para> - The latest version of this guide can always be found at <ulink - url="http://www.bugzilla.org"/>, or checked out via CVS by - following the <ulink url="http://www.mozilla.org/cvs.html">Mozilla - CVS</ulink> instructions and check out the - <filename>mozilla/webtools/bugzilla/docs/</filename> - subtree. However, you should read the version - which came with the Bugzilla release you are using. - </para> - <para> - The Bugzilla Guide, or a section of it, is also available in - the following languages: - <ulink url="http://bugzilla-de.sourceforge.net/docs/html/">German</ulink>. - </para> - - <para> - In addition, there are Bugzilla template localisation projects in - the following languages. They may have translated documentation - available: - <ulink url="http://sourceforge.net/projects/bugzilla-be/">Belarusian</ulink>, - <ulink url="http://sourceforge.net/projects/bugzilla-br/">Brazilian Portuguese</ulink>, - <ulink url="http://sourceforge.net/projects/bugzilla-cn/">Chinese</ulink>, - <ulink url="http://sourceforge.net/projects/bugzilla-fr/">French</ulink>, - <ulink url="http://sourceforge.net/projects/bugzilla-de/">German</ulink>, - <ulink url="http://sourceforge.net/projects/bugzilla-kr/">Korean</ulink>, - <ulink url="http://sourceforge.net/projects/bugzilla-ru/">Russian</ulink> and - <ulink url="http://sourceforge.net/projects/bugzilla-es/">Spanish</ulink>. - </para> - - <para> - If you would like to volunteer to translate the Guide into additional - languages, please contact - <ulink url="mailto:justdave@syndicomm.com">Dave Miller</ulink>. + 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. + </para> + <para> + This document can be found in the following places: + </para> + <para> + <itemizedlist> + <listitem> + <para> + <ulink url="http://www.bugzilla.org/">bugzilla.org</ulink> + </para> + </listitem> + <listitem> + <para> + <ulink url="http://www.linuxdoc.org/">The Linux + Documentation Project</ulink> + </para> + </listitem> + </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. </para> </section> @@ -109,38 +144,58 @@ <title>Credits</title> <para> 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: </para> + <para> + <ulink url="mailto://mbarnson@sisna.com">Matthew P. Barnson</ulink> + for pulling together the Bugzilla Guide and shepherding it to 2.14. + </para> + <para> + <ulink url="mailto://terry@mozilla.org">Terry Weissman</ulink> + for initially writing Bugzilla and creating the + 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 + </para> + <para> + <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> + <para> + <ulink url="mailto://endico@mozilla.org">Dawn Endico</ulink> for + being a hacker extraordinaire and putting up with my incessant + 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. + </para> + <para> + Thanks also go to the following people for significant contributions + to this documentation (in no particular order): + </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> - <simplelist type="inline"> - <member>Matthew P. Barnson</member> - <member>Kevin Brannen</member> - <member>Dawn Endico</member> - <member>Ben FrantzDale</member> - <member>Eric Hanson</member> - <member>Tara Hernandez</member> - <member>Dave Lawrence</member> - <member>Zach Lipton</member> - <member>Gervase Markham</member> - <member>Andrew Pearson</member> - <member>Joe Robins</member> - <member>Spencer Smith</member> - <member>Jacob Steenhagen</member> - <member>Ron Teitelbaum</member> - <member>Terry Weissman</member> - <member>Martin Wulffeld</member> - </simplelist>. - </para> - - <para> - Also, thanks are due to 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. + 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. </para> </section> @@ -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: --> |