[or-cvs] r15582: clean up the pootle instructions a bit (website/trunk/en)

[arma@xxxxxxxx]

Author: arma
Date: 2008-07-01 16:30:57 -0400 (Tue, 01 Jul 2008)
New Revision: 15582

Modified:
   website/trunk/en/translation-portal.wml
Log:
clean up the pootle instructions a bit


Modified: website/trunk/en/translation-portal.wml
===================================================================
--- website/trunk/en/translation-portal.wml	2008-07-01 20:26:23 UTC (rev 15581)
+++ website/trunk/en/translation-portal.wml	2008-07-01 20:30:57 UTC (rev 15582)
@@ -34,9 +34,10 @@
 <hr />
 
 <p>
-The <a href="https://translation.torproject.org/";>Tor Translation Portal</a> is
-a system which lists all sentences in use in a particular project, and allows
-interested volunteers to translate individual
+The <a href="https://translation.torproject.org/";>Tor Translation Portal</a>
+is a website that lists all sentences or phrases (called "strings") used
+by a particular project, and allows interested volunteers to translate
+individual
 sentences or phrases as they are able.
 </p>
 
@@ -117,17 +118,18 @@
 </p>
 
 <p>
-At this point, you'll want to select a project, such as <a
+At this point, you can select a project, such as <a
 href="https://translation.torproject.org/projects/vidalia/";>Vidalia</a>. You'll
 see a nice list of all of the currently supported languages along with the
-current translation progress. Select a language, in our example, you'll click
+current translation progress. Select a language &mdash; in our example,
+you'll click
 <a href="https://translation.torproject.org/de/vidalia/";>German</a>. The next
 page should show you a single row of data for the file "<a
-href='https://translation.torproject.org/de/vidalia/vidalia.po?translate=1&view=1'>vidalia.po</a>".
+href='https://translation.torproject.org/de/vidalia/vidalia.po?translate=1&view=1'>vidalia_de.po</a>".
 This is the file with all of the currently translated German strings for
-Vidalia. You'll want to click on the "<a
+Vidalia. You should click on the "<a
 href='https://translation.torproject.org/de/vidalia/index.html?editing=1'>Show
-Editing Functions</a>" link above the 'vidalia.po' row. Next you'll want to
+Editing Functions</a>" link above the 'vidalia_de.po' row. Next you should
 click the "<a
 href='https://translation.torproject.org/de/vidalia/translate.html?fuzzy=1&editing=1&blank=1'>Quick
 Translate</a>" link. This will take you to the first untranslated string in the
@@ -142,10 +144,10 @@
 </p>
 
 <p>
-When you're finished, you'll want to commit your changes by returning to the
+When you're finished, you need to commit your changes. Return to the
 page with the <a
 href="https://translation.torproject.org/de/vidalia/index.html?editing=1";>Editing
-Functions</a>. You'll want to click on the "<a
+Functions</a>, and click on the "<a
 href='https://translation.torproject.org/de/vidalia/index.html?editing=1&docommit=1&commitfile=vidalia.po'>Commit</a>"
 link. This will commit your changes into the <a
 href="https://tor-svn.freehaven.net/svn/translation/trunk/projects/vidalia/de/";>Translation
@@ -154,22 +156,27 @@
 </p>
 
 <p>
+That's all there is to it!
+</p>
+
+<p>
 For more advanced users who like to translate without a web browser, you can
 also download the .po file directly. You'll find this option after clicking on
 the "<a
 href='https://translation.torproject.org/de/vidalia/index.html?editing=1'>Show
 Editing Functions</a>" link. You should see a link to download the <a
 href="https://translation.torproject.org/de/vidalia/vidalia.po";>PO file</a>. If
-this option fits your working habits, by all means, please use it! When you're
-finished translating the .po file, you can upload it by using the "upload file"
-form in the upper right hand corner, simply select the file and click the
-'Upload file' button. 
+this option fits your working habits, by all means, please use it!
+You may find a program called <a href="http://www.poedit.net/";>Poedit</a>
+to make the job easier, especially for right-to-left languages that don't
+work as well in text editors. If you're using Poedit, you should disable
+compiling .mo files in Poedit's preferences (File -&gt; Preferences -&gt;
+Editor -&gt; Behavior, uncheck "Automatically compile .mo file on save").
+When you're finished translating the .po file, you can upload it by
+using the "upload file" form in the upper right hand corner: simply
+select the file and click the 'Upload file' button.
 </p>
 
-<p>
-That's all there is to it!
-</p>
-
 <a id="TranslatingVidalia"></a>
 <h2>
 <a class="anchor" href="#TranslatingVidalia">Other Vidalia translation efforts</a>