tor-webwml.git

@@ -11,9 +11,8 @@

 <p>

 If you want to help translate the Tor website and documentation into

 other languages, here are some guidelines to help you do this as

-efficiently as possible. Rather than just translating each page word

-by word, please try to translate the ideas so they make the most sense

-in your language.</p>

+efficiently as possible.

+</p>

 <p>

 To get an idea how

@@ -23,7 +22,9 @@ current our translations are, we have created a page with the current

 <p>

 Note that even if you can't translate many pages for your language,

 a few pages will still be helpful.

-</p>

+Also, rather than just translating each page word

+by word, please try to translate the ideas so they make the most sense

+in your language.</p>

 <ol>

 <li>Look in <a

@@ -38,10 +39,10 @@ for examples of the desired translation formats.</li>

 <li>The first line in the translated file should be<br />

 \# Based-On-Revision: 13000<br />

-where 13000 is the revision number of the original page translated. This

+where 13000 is the revision number of the original English page. This

 lets you easily spot when a page gets out of date. The revision number

-is found at

-the top on each page -- it is created by SVN so be sure to

+is found at the top on each page -- you can either look at the files in the

+<a href="<svnwebsite>en/"><svnwebsite>en/</a> directory, or manually

 <a href="<page documentation>#Developers">checkout</a> the latest version

 of the website.</li>

@@ -57,7 +58,10 @@ you may want to obfuscate your email address or use a separate one.)</li>

 the text that should go in the diagrams, and we'll take care of making

 new versions of the pictures.</li>

-<li>Translated pages should link to the other translated pages.</li>

+<li>Translated pages should link to the other translated pages. In general

+this is automatic: writing <code>&lt;page download&gt;</code>

+will automatically link to the translated version of that page if

+there is one, and the English version otherwise.</li>

 <li>Use valid <a href="http://roselli.org/adrian/articles/character_charts.asp">character entities</a>.

 Even though most browsers display the characters correctly these days, we want

@@ -67,15 +71,15 @@ add something like <code>CHARSET="UTF-8"</code> to the end of the line

 that starts with <code>#include "head.wmi"</code>.

 </li>

-<li>Keep your translation valid XHTML to minimize the work needed

-before the page is committed to SVN. You can test your page at <a

+<li>Keep your translation valid XHTML. Once it's in place, you can test

+your page at <a

 href="http://validator.w3.org/">validator.w3.org</a>.</li>

 <li>When you have some pages ready, send them to the

 <tt>tor-translation</tt> alias on the <a href="<page contact>">contact

 page</a>.  (If you have changes to existing pages, please use the diff

 tool to generate patch files, if possible.)  If you plan to stick

-around and keep maintaining them, we'll

+around and keep maintaining them, let us know and we'll

 be happy to give you an SVN account to manage them directly.</li>

 </ol>