Bug 364013: "Add individual bugs to..." should be reworded - Patch by Frédéric Buclin <LpSolit@gmail.com> r=mkanat a=justdave

1 files changed, 15 insertions, 14 deletions

diff --git a/docs/xml/using.xml b/docs/xml/using.xml
index 3a16d8287..d87b76e36 100644
--- a/docs/xml/using.xml
+++ b/docs/xml/using.xml
@@ -658,27 +658,28 @@
     </section>
 
     <section id="individual-buglists">
-      <title>Adding/removing individual bugs from bug lists</title>
+      <title>Adding/removing tags to/from bugs</title>
       <para>
-        You can at any time add and remove individual bugs to a special type
-        of saved searches, known as <quote>lists of bugs</quote>. The distinction
-        between both types is that saved searches, as described in the previous
-        section, are stored in the form of a list of matching criteria, while
-        a list of bugs is an enumerated list of bug numbers. As it is a simple
-        list of bug numbers, you can easily edit this list by either adding or
-        removing bugs from it. To enable this feature, you have to turn on the
-        <quote>Add individual bugs to saved searches</quote> user preference,
-        see <xref linkend="userpreferences" />. This feature is disabled by
-        default.
+        You can add and remove tags from individual bugs, which let you find and
+        manage them more easily. Creating a new tag automatically generates a saved
+        search - whose name is the name of the tag - which lists bugs with this tag.
+        This saved search will be displayed in the footer of pages by default, as
+        all other saved searches. The main difference between tags and normal saved
+        searches is that saved searches, as described in the previous section, are
+        stored in the form of a list of matching criteria, while the saved search
+        generated by tags is a list of bug numbers. Consequently, you can easily
+        edit this list by either adding or removing tags from bugs. To enable this
+        feature, you have to turn on the <quote>Enable tags for bugs</quote> user
+        preference, see <xref linkend="userpreferences" />. This feature is disabled
+        by default.
       </para>
 
       <para>
         This feature is useful when you want to keep track of several bugs, but
         for different reasons. Instead of adding yourself to the CC list of all
         these bugs and mixing all these reasons, you can now store these bugs in
-        different lists, e.g. <quote>Bugs I want to see fixed before the next
-        release</quote>, <quote>Interesting bugs</quote>, or <quote>Bugs I have
-        to think about</quote>. One big advantage of this way to manage bug lists
+        separate lists, e.g. <quote>Keep in mind</quote>, <quote>Interesting bugs</quote>,
+        or <quote>Triage</quote>. One big advantage of this way to manage bugs
         is that you can easily add or remove bugs one by one, which is not
         possible to do with saved searches without having to edit the search
         criteria again.