[Bf-docboard-svn] bf-manual: [8451] trunk/blender_docs/manual/about/contribute/translations/contribute.rst: Update Editing Translation Files

[Aaron Carlisle]

Revision: 8451
          https://developer.blender.org/rBM8451
Author:   Blendify
Date:     2021-10-06 02:50:23 +0200 (Wed, 06 Oct 2021)
Log Message:
-----------
Update Editing Translation Files

Modified Paths:
--------------
    trunk/blender_docs/manual/about/contribute/translations/contribute.rst

Modified: trunk/blender_docs/manual/about/contribute/translations/contribute.rst
===================================================================
--- trunk/blender_docs/manual/about/contribute/translations/contribute.rst	2021-10-04 17:02:00 UTC (rev 8450)
+++ trunk/blender_docs/manual/about/contribute/translations/contribute.rst	2021-10-06 00:50:23 UTC (rev 8451)
@@ -83,16 +83,24 @@
 Editing Translation Files
 =========================
 
-Now you can edit the PO translation files, e.g:
+Now you can edit the PO translation files, in the ``LC_MESSAGES`` folder you have two files:
 
-Original RST File
-   ``manual/getting_started/about_blender/introduction.rst``
-Generated PO File
-   ``locale/fr/LC_MESSAGES/getting_started/about_blender/introduction.po``
+- ``blender_manual.po`` -- This is the main translation file that you will be editing.
+- ``sphinx.po`` -- This translation file is much smaller and contains translations for the website theme.
 
-The modified ``.po`` files can be edited and committed back to svn.
+To edit these files open them up in your translation editor, ie Poedit.
+Once in your editor you will see a list of texts, each of these items represent some part of the user manual.
+You may need to adjust your editor to sort the list in a way that makes sense for example "by source".
 
+You can now select an untranslated string and your editor will have an input box to add the translation.
+The modified ``.po`` files can now submitted as a patch or committed back to svn.
 
+.. tip::
+
+   Make sure that you `Building with Translations`_ to catch any syntax errors you may make while translating.
+   These errors will be displayed as warnings while building the manual.
+
+
 Commit Translation Files
 ========================