translation-quick-start-guide/en_US rpm-info.xml, 1.11, 1.12 translation-quick-start.xml, 1.19, 1.20

[Paul W. Frields (pfrields)]

Author: pfrields

Update of /cvs/docs/translation-quick-start-guide/en_US
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv7468/en_US

Modified Files:
	rpm-info.xml translation-quick-start.xml 
Log Message:
- Add information on branch modules and docs-common inclusion
- Add admonition to test changes before committing them




Index: rpm-info.xml
===================================================================
RCS file: /cvs/docs/translation-quick-start-guide/en_US/rpm-info.xml,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -r1.11 -r1.12
--- rpm-info.xml	6 Jul 2007 14:06:23 -0000	1.11
+++ rpm-info.xml	28 Jul 2007 21:27:33 -0000	1.12
@@ -44,6 +44,10 @@
   <title>Translation Quick Start Guide</title>
   <desc>Quick start guide to providing translations on the Fedora Project.</desc>
   <changelog order="newest-first">
+    <revision date="2007-07-28" number="0.3.7.4">
+      <author worker="PaulWFrields"/>
+      <details>Add information on branch modules and testing changes</details>
+    </revision>
     <revision date="2007-07-06" number="0.3.7.3">
       <author worker="PaulWFrields"/>
       <details>Make admonition against manual POT changes</details>


Index: translation-quick-start.xml
===================================================================
RCS file: /cvs/docs/translation-quick-start-guide/en_US/translation-quick-start.xml,v
retrieving revision 1.19
retrieving revision 1.20
diff -u -r1.19 -r1.20
--- translation-quick-start.xml	6 Jul 2007 14:05:02 -0000	1.19
+++ translation-quick-start.xml	28 Jul 2007 21:27:33 -0000	1.20
@@ -476,13 +476,21 @@
       <para>
 	To download a module to translate, list the current modules in
 	the repository and then check out that module.  You must also
-	check out the <filename>docs-common</filename> module.
+	check out the <filename>docs-common</filename> module to work
+	with some modules.
       </para>
 
 <screen>
 <command>cvs co example-tutorial docs-common</command>
 </screen>
 
+      <para>Modules that are created for each release of &DISTRO; are
+	separated into <firstterm>branches</firstterm>.  The branch
+	shows the release of &DISTRO; for which that document was
+	created.  The <filename>release-notes-F-7</filename> module, for
+	example, contains the branch of the <citetitle>Release
+	Notes</citetitle> created for Fedora 7.</para>
+
       <para>
 	The documents are written in DocBook XML format.  Each is stored
 	in a directory named for the specific-language locale, such as
@@ -668,6 +676,13 @@
 <command>make html-<replaceable>pt_BR</replaceable></command>
 </screen>
 
+	  <important>
+	    <title>Always Test Your Translation</title>
+	    <para>Do not go to the next step or commit changes until you
+	      test your work in this step.  Erroneous changes can break
+	      documents for other users, editors, and automated
+	    applications.</para>
+	  </important>
 	</step>
 	<step>
 	  <para>