translation-guide-windows/en_US rpm-info.xml, 1.2, 1.3 translate-windows.xml, 1.3, 1.4

Paul W. Frields (pfrields) fedora-docs-commits at redhat.com
Tue Aug 14 15:16:02 UTC 2007


Author: pfrields

Update of /cvs/docs/translation-guide-windows/en_US
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv4894/en_US

Modified Files:
	rpm-info.xml translate-windows.xml 
Log Message:
* 0.1.6
  - Numerous style and grammar edits
  - DocBook usage edits (sectN -> section)
  - Procedures use DocBook <procedure> elements




Index: rpm-info.xml
===================================================================
RCS file: /cvs/docs/translation-guide-windows/en_US/rpm-info.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- rpm-info.xml	15 Jul 2007 13:50:16 -0000	1.2
+++ rpm-info.xml	14 Aug 2007 15:15:59 -0000	1.3
@@ -23,6 +23,10 @@
   <title>Translate Fedora in Microsoft Windows</title>
   <desc>How to translate Fedora resources using Microsoft Windows</desc>
   <changelog order="newest-first">
+    <revision date="2007-08-14" number="0.1.6">
+      <author worker="PaulWFrields"/>
+      <details>Editorial changes throughout for style, grammar, usage</details>
+    </revision>
     <revision date="2007-07-15" number="0.1.5">
       <author worker="PaulWFrields"/>
       <details>Update file sources to current FDP standards</details>


View full diff with command:
/usr/bin/cvs -f diff  -kk -u -N -r 1.3 -r 1.4 translate-windows.xml
Index: translate-windows.xml
===================================================================
RCS file: /cvs/docs/translation-guide-windows/en_US/translate-windows.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- translate-windows.xml	15 Jul 2007 14:00:57 -0000	1.3
+++ translate-windows.xml	14 Aug 2007 15:15:59 -0000	1.4
@@ -13,7 +13,7 @@
     <xi:fallback>rpm-info.xml file is missing</xi:fallback>
   </xi:include>
 
-  <sect1 id="s1-intro">
+  <section id="s1-intro">
     <title>Introduction</title>
 
     <indexterm>
@@ -21,52 +21,50 @@
     </indexterm>
 
     <para>
-      To join the Fedora translation team and work with people around
-      the world is easy in <trademark
-	class="registered">Microsoft</trademark> <trademark
-	class="registered">Windows</trademark> as well. To achieve this,
-      several tools are needed:
+      People who use <trademark class="registered">Microsoft</trademark>
+      <trademark class="registered">Windows</trademark> can also join
+      the Fedora translation team and work with people around the world.
+      To participate, you need several tools:
     </para>
 
     <itemizedlist>
       <listitem>
 	<para>
-	  A Web Browser that supports cookies
+	  A web browser that supports cookies
 	</para>
       </listitem>
       <listitem>
 	<para>
 	  A <application>Concurrent Versions System</application>
-	  (<acronym>CVS</acronym>) client — This artical uses
-	  <application>TortoiseCVS</application>
+	  (<acronym>CVS</acronym>) client.  This article uses
+	  <application>TortoiseCVS</application>.
 	</para>
       </listitem>
       <listitem>
 	<para>
-	  An editor for <filename>.po</filename> files — This
-	  article uses <application>poEdit</application>
+	  An editor for <filename>.po</filename> files.  This
+	  article uses <application>poEdit</application>.
 	</para>
       </listitem>
       <listitem>
 	<para>
-	  A Secury Shell (<acronym>ssh</acronym>) client — This
-	  article uses <application>puttygen</application> which is a
-	  free utility that generates personalized digital ID, using
-	  public key infrastructure. This utility is bundled within
-	  <application>TortoiseCVS</application>
+	  A Secure Shell (<acronym>ssh</acronym>) client.  This article
+	  uses <application>puttygen</application>, a free utility that
+	  generates a personalized digital ID using a public key
+	  infrastructure. This utility is bundled within
+	  <application>TortoiseCVS</application>.
 	</para>
       </listitem>
     </itemizedlist>
 
     <para>
-      This article will introduce you where to find and download these
-      tools, how to install and setup, and even a brief description of
-      how to use them.
+      This article shows you where to find and download these tools, how
+      to install and configure them, and how to use them.
     </para>
 
-  </sect1>
+  </section>
 
-  <sect1 id="s1-cvs">
+  <section id="s1-cvs">
     <title>Download and Install
       <application>TortoiseCVS</application></title>
 
@@ -80,9 +78,9 @@
     </indexterm>
 
     <para>
-      To download <application>TortoiseCVS</application>, go to <ulink
+      To download <application>TortoiseCVS</application>, visit <ulink
 	url="http://www.tortoisecvs.org/download.shtml">http://www.tortoisecvs.org/download.shtml</ulink>. 
-      For demonstration purpose, this artical uses
+      For demonstration purposes, this article uses
       <filename>TortoiseCVS-1.6.14</filename>.
     </para>
 
@@ -92,291 +90,288 @@
       the installation process step by step:
     </para>
 
-    <itemizedlist>
-      <listitem>
+    <procedure>
+      <step>
 	<para>
-    Step 1: Welcome to TortoiseCVS setup (as shown in
-	<xref linkend="fig-tortoise-setup1"/>). Press
-	  <guibutton>Next></guibutton> to continue.
+	  The <guilabel>Welcome to TortoiseCVS setup</guilabel> screen
+	  appears, as shown in
+	  <xref linkend="fig-tortoise-setup1"/>. Press
+	  <guibutton>Next</guibutton> to continue.
 	</para>
-      </listitem>
-      <listitem>
+	<figure id="fig-tortoise-setup1">
+	  <title>Welcome to TortoiseCVS setup</title>
+	  <mediaobject>
+	    <imageobject>
+	      <imagedata fileref="./figs/tortoise/image001.eps"
+	    format="EPS"/>
+	    </imageobject>
+	    <imageobject>
+	      <imagedata fileref="./figs/tortoise/image001.jpg"
+	    format="JPG"/>
+	    </imageobject>
+	    <textobject>
+	      <phrase>
+		Welcome to TortoiseCVS setup.
+	      </phrase>
+	    </textobject>
+	  </mediaobject>
+	</figure>
+      </step>
+      <step>
 	<para>
-    Step 2: Select destination directory (as shown in <xref
-	    linkend="fig-tortoise-setup2"/>). Customize your directory
-	  or press <guibutton>Next></guibutton> to accept the default
+	  Select a destination directory, as shown in <xref
+	    linkend="fig-tortoise-setup2"/>. Customize your directory or
+	  press <guibutton>Next</guibutton> to accept the default
 	  setting.
 	</para>
-      </listitem>
-      <listitem>
+	<figure id="fig-tortoise-setup2">
+	  <title>Select Destination Directory</title>
+	  <mediaobject>
+	    <imageobject>
+	      <imagedata fileref="./figs/tortoise/image002.eps"
+	    format="EPS"/>
+	    </imageobject>
+	    <imageobject>
+	      <imagedata fileref="./figs/tortoise/image002.jpg"
+	    format="JPG"/>
+	    </imageobject>
+	    <textobject>
+	      <phrase>
+		Select destination directory.
+	      </phrase>
+	    </textobject>
+	  </mediaobject>
+	</figure>
+      </step>
+      <step>
 	<para>
-    Step 3: Select components (as shown in <xref
-	    linkend="fig-tortoise-setup3"/>). To accept
-	  <emphasis>full</emphasis> installation, press
-	  <guibutton>Next></guibutton>.
-	</para>
-      </listitem>
-      <listitem>
+	  Select components, as shown in <xref
+	    linkend="fig-tortoise-setup3"/>. To accept the default
+	  <guilabel>full</guilabel> installation, press
+	  <guibutton>Next</guibutton>.</para>
+	<figure id="fig-tortoise-setup3">
+	  <title>Select Components</title>
+	  <mediaobject>
+	    <imageobject>
+	      <imagedata fileref="./figs/tortoise/image003.eps"
+		format="EPS"/>
+	    </imageobject>
+	    <imageobject>
+	      <imagedata fileref="./figs/tortoise/image003.jpg"
+		format="JPG"/>
+	    </imageobject>
+	    <textobject>
+	      <phrase>
+		Select components.
+	      </phrase>
+	    </textobject>
+	  </mediaobject>
+	</figure>
[...2105 lines suppressed...]
-          format="EPS"/>
+	      format="EPS"/>
 	  </imageobject>
 	  <imageobject>
 	    <imagedata fileref="./figs/tortoise/cvs_commit.jpg"
-          format="JPG"/>
+	      format="JPG"/>
 	  </imageobject>
 	  <textobject>
 	    <phrase>
@@ -1528,9 +1539,9 @@
       </figure>
 
       <para>
-	Again, you'll be prompted the passphrase of your private key.
-	After files are successfully uploaded to server, you will see a
-	screen similar to <xref
+	A prompt appears for the passphrase of your private key. After
+	files are successfully uploaded to server, a screen appears
+	similar to <xref
 	  linkend="fig-cycle-11"/>.
       </para>
       <figure id="fig-cycle-11">
@@ -1538,11 +1549,11 @@
 	<mediaobject>
 	  <imageobject>
 	    <imagedata fileref="./figs/cycle/cvs_up_commit.eps"
-          format="EPS"/>
+	      format="EPS"/>
 	  </imageobject>
 	  <imageobject>
 	    <imagedata fileref="./figs/cycle/cvs_up_commit.jpg"
-          format="JPG"/>
+	      format="JPG"/>
 	  </imageobject>
 	  <textobject>
 	    <phrase>
@@ -1551,23 +1562,22 @@
 	  </textobject>
 	</mediaobject>
       </figure>
-    </sect2>
+    </section>
 
-    <sect2 id="s2-cycle-5">
-      <title> Phase 5 </title>
+    <section id="s2-cycle-5">
+      <title>Phase 5</title>
       <indexterm>
 	<primary>Status page</primary>
 	<secondary>release</secondary>
       </indexterm>
       <para>
-	The phase is an optional one, only occurs when you decide to
-	stop working on a file before it's fully translated. For
-	example, you may go on a holiday and don't want to keep working
-	on a file but would like others to be able to resume the work.
-	To do so, you need to go to the Fedora status page, find the
-	package you had taken, and click the package name to view the
-	detail. On the bottom of that page, you would see the
-	<guibutton>Release</guibutton> link, as shown in <xref
+	This phase is optional, and only occurs when you stop working on
+	a file before it is fully translated. For example, you may go on
+	a holiday, but would like others to be able to resume the work.
+	To do so, visit the Fedora status page, find the package you
+	previously took, and click the package name to view the detail.
+	On the bottom of that page, a <guibutton>Release</guibutton>
+	link appears, as shown in <xref
 	  linkend="fig-cycle-12"/>.
       </para>
       <figure id="fig-cycle-12">
@@ -1575,11 +1585,11 @@
 	<mediaobject>
 	  <imageobject>
 	    <imagedata fileref="./figs/cycle/fedora_released.eps"
-          format="EPS"/>
+	      format="EPS"/>
 	  </imageobject>
 	  <imageobject>
 	    <imagedata fileref="./figs/cycle/fedora_released.jpg"
-          format="JPG"/>
+	      format="JPG"/>
 	  </imageobject>
 	  <textobject>
 	    <phrase>
@@ -1594,12 +1604,12 @@
 	translation. We do hope you enjoy being with part of the open
 	source community and continue lending your support.
       </para>
-    </sect2>
-  </sect1>
+    </section>
+  </section>
 
-  <sect1 id="s1-resource">
+  <section id="s1-resource">
     <title>Other Resources</title>
-    <sect2 id="s2-resource-website">
+    <section id="s2-resource-website">
       <title> Related Websites </title>
       <indexterm>
 	<primary>resource</primary>
@@ -1608,76 +1618,71 @@
 
       <variablelist>
 	<varlistentry>
-	  <term> Official website of
+	  <term>Official website of
 	    <application>TortoiseCVS</application></term>
 	  <listitem>
 	    <para>
-	      <ulink
-		url="http://www.tortoisecvs.org/">http://www.tortoisecvs.org/</ulink>
+	      <ulink url="http://www.tortoisecvs.org/"/>
 	    </para>
 	  </listitem>
 	</varlistentry>
 	<varlistentry>
-	  <term> Official website of
+	  <term>Official website of
 	    <application>poEdit</application></term>
 	  <listitem>
 	    <para>
-	      <ulink
-		url="http://poedit.sourceforge.net/">http://poedit.sourceforge.net/</ulink>
+	      <ulink url="http://poedit.sourceforge.net/"/>
 	    </para>
 	  </listitem>
 	</varlistentry>
 	<varlistentry>
-	  <term> Official website of
+	  <term>Official website of
 	    <application>PuTTY</application></term>
 	  <listitem>
 	    <para>
 	      <ulink
-		url="http://www.chiark.greenend.org.uk/~sgtatham/putty/">http://www.chiark.greenend.org.uk/~sgtatham/putty/</ulink>
+		url="http://www.chiark.greenend.org.uk/~sgtatham/putty/"/>
 	    </para>
 	  </listitem>
 	</varlistentry>
 	<varlistentry>
-	  <term>  <application>WinCvs</application> CVS Client </term>
+	  <term><application>WinCvs</application> CVS Client</term>
 	  <listitem>
 	    <para>
 	      <application>WinCvs</application> is an alternative CVS
 	      client you can use. The following article describes its
-	      installation steps in detail. <ulink
-		url="http://sourceforge.net/docman/display_doc.php?docid=766&group_id=1">http://sourceforge.net/docman/display_doc.php?docid=766&group_id=1</ulink>
+	      installation steps in detail: <ulink
+		url="http://sourceforge.net/docman/display_doc.php?docid=766&group_id=1"/>
 	    </para>
 	  </listitem>
 	</varlistentry>
 	<varlistentry>
-	  <term> A good CVS guide</term>
+	  <term>A good CVS guide</term>
 	  <listitem>
 	    <para>
 	      <ulink
-		url="http://www.loria.fr/~molli/cvs/doc/cvs_toc.html">http://www.loria.fr/~molli/cvs/doc/cvs_toc.html</ulink>
+		url="http://www.loria.fr/~molli/cvs/doc/cvs_toc.html"/>
 	    </para>
 	  </listitem>
 	</varlistentry>
       </variablelist>
-    </sect2>
+    </section>
 
-    <sect2 id="s2-resource-feedback">
-      <title> Your Feedback </title>
+    <section id="s2-resource-feedback">
+      <title>Your Feedback</title>
       <para>
-	Your feedback is always welcome! If you have spotted any typo or
-	errors, please contact <ulink
+	Your feedback is always welcome. If you spot any typo or errors
+	in this document, please contact <ulink
 	  url="mailto:ccheng at redhat.com?subject=[Fedora translation in
 	  Windows] ">Chester Cheng</ulink>, or simply discuss it through
 	<ulink
 	  url="http://www.redhat.com/mailman/listinfo/fedora-trans-list"> 
-	  Fedora Translation List</ulink>.
-      </para>
-
-      <para>
-	Hope this article has helped you to set things up.  Looking
-	forward to hearing from you!
+	  Fedora Translation List</ulink>.  You can also file a bug in
+	&BZ; against the product "&FED; Documentation," and the
+	component "translation-guide-windows."
       </para>
-    </sect2>
-  </sect1>
+    </section>
+  </section>
 
   <index id="generated-index"></index>
 </article>




More information about the Fedora-docs-commits mailing list