Phase 1 of a big documentation update before 2.17.6.

1 files changed, 33 insertions, 53 deletions

diff --git a/docs/xml/introduction.xml b/docs/xml/introduction.xml
index 8b09fe2b5..d01e39979 100644
--- a/docs/xml/introduction.xml
+++ b/docs/xml/introduction.xml
@@ -1,23 +1,44 @@
 <chapter id="introduction">
   <title>Introduction</title>
 
-  <section id="whatis">
+  <section id="what-is-bugzilla">
     <title>What is Bugzilla?</title>
 
     <para>
     Bugzilla is a bug- or issue-tracking system. Bug-tracking
     systems allow individual or groups of developers effectively to keep track
-    of outstanding problems with their product. 
-    Bugzilla was originally
-    written by Terry Weissman in a programming language called TCL, to
-    replace a rudimentary bug-tracking database used internally by Netscape
-    Communications. Terry later ported Bugzilla to Perl from TCL, and in Perl
-    it remains to this day. Most commercial defect-tracking software vendors
-    at the time charged enormous licensing fees, and Bugzilla quickly became
-    a favorite of the open-source crowd (with its genesis in the open-source
-    browser project, Mozilla). It is now the de-facto standard
-    defect-tracking system against which all others are measured.
+    of outstanding problems with their products. 
     </para>
+    
+    <para><emphasis>Do we need more here?</emphasis></para>
+    
+  </section>
+
+  <section id="why-tracking">
+    <title>Why use a bug-tracking system?</title>
+    
+    <para>For many years, defect-tracking software was principally
+    the domain of large software development houses. Most smaller shops
+    simply relied on
+    shared lists and email to monitor the status of defects. This procedure
+    was error-prone and tended to cause those bugs judged least significant by
+    developers to be dropped or ignored.</para>
+
+    <para>Integrated
+    defect-tracking systems reduce downtime, increase productivity, and raise
+    customer satisfaction with their systems. Along with full disclosure, an
+    open bug-tracker allows you to keep in touch with your clients
+    and resellers, to communicate about problems effectively throughout the
+    data management chain. Many corporations have also discovered that
+    defect-tracking helps reduce costs by providing IT support
+    accountability, telephone support knowledge bases, and a common,
+    well-understood method for accounting for unusual system or software
+    issues.</para>
+    
+  </section>
+    
+  <section id="why-bugzilla">
+    <title>Why use Bugzilla?</title>
 
     <para>Bugzilla boasts many advanced features. These include: 
     <itemizedlist>
@@ -71,34 +92,7 @@
       </listitem>
     </itemizedlist>
     </para>
-  </section>
-
-  <section id="why">
-    <title>Why Should We Use Bugzilla?</title>
-
-    <para>For many years, defect-tracking software has remained principally
-    the domain of large software development houses. Even then, most shops
-    never bothered with bug-tracking software, and instead simply relied on
-    shared lists and email to monitor the status of defects. This procedure
-    is error-prone and tends to cause those bugs judged least significant by
-    developers to be dropped or ignored.</para>
-
-    <para>These days, many companies are finding that integrated
-    defect-tracking systems reduce downtime, increase productivity, and raise
-    customer satisfaction with their systems. Along with full disclosure, an
-    open bug-tracker allows manufacturers to keep in touch with their clients
-    and resellers, to communicate about problems effectively throughout the
-    data management chain. Many corporations have also discovered that
-    defect-tracking helps reduce costs by providing IT support
-    accountability, telephone support knowledge bases, and a common,
-    well-understood system for accounting for unusual system or software
-    issues.</para>
-
-    <para>But why should 
-    <emphasis>you</emphasis>
-
-    use Bugzilla?</para>
-
+    
     <para>Bugzilla is very adaptable to various situations. Known uses
     currently include IT support queues, Systems Administration deployment
     management, chip design and development problem tracking (both
@@ -110,20 +104,6 @@
     <ulink url="http://www.perforce.com">Perforce SCM</ulink>, Bugzilla
     provides a powerful, easy-to-use solution to configuration management and
     replication problems.</para>
-
-    <para>Bugzilla can dramatically increase the productivity and
-    accountability of individual employees by providing a documented workflow
-    and positive feedback for good performance. How many times do you wake up
-    in the morning, remembering that you were supposed to do 
-    <emphasis>something</emphasis>
-    today, but you just can't quite remember? Put it in Bugzilla, and you
-    have a record of it from which you can extrapolate milestones, predict
-    product versions for integration, and  follow the discussion trail 
-    that led to critical decisions.</para>
-
-    <para>Ultimately, Bugzilla puts the power in your hands to improve your
-    value to your employer or business while providing a usable framework for
-    your natural attention to detail and knowledge store to flourish.</para>
   </section>
 </chapter>