openstack
/
i18n
Code Issues Proposed changes

doc: minor modification of translation check page 

Change-Id: I8bedfbfa7ae817f9e86ad144d6a433e28d02dcbd
This commit is contained in:
Akihiro Motoki 2016-08-19 18:37:47 +01:00
parent 842e251615
commit dddfd8fe1a
1 changed files with 8 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
doc/source/check_translation.rst
View File

@ -24,19 +24,20 @@ To build a translated document, you need to update the file
add an entry to ``BOOKS`` like ``["ja"]="install-guide"``.
Also, to build as a draft, you need to add an entry to ``DRAFTS``.
For the document in a stable branch, such as the installation guide for
For a document in a stable branch, such as the installation guide for
Liberty, you need to update the file ``doc-tools-check-languages.conf``
in the target stable branch directly.
You must add an entry to ``DRAFTS``, which is used as a special flag
for a stable branch.
You can check generated documents for the specified project on
You can check a generated document for a specified branch on
http://docs.openstack.org/<branch>/<language>/<document>.
For example, the link of Ubuntu Installation Guide for Liberty is
http://docs.openstack.org/liberty/ja/install-guide-ubuntu/.
To add a link to the generated document, you need to update the file
``www/<lang>/index.html`` in the ``openstack-manuals`` repository.
To add a link to a generated document, you need to update the file
``www/<lang>/index.html`` in the ``master`` branch of
the ``openstack-manuals`` repository.
Note that the web pages are published from ``master`` branch,
which contains the pages for all releases, such as Liberty.
Therefore, you don't need to update the file ``www/<lang>/index.html``
@ -69,9 +70,10 @@ Running DevStack
Another convenient way is to check dashboard translations is to run
DevStack in your local environment. To run DevStack, you need to
prepare ``local.conf`` file, but no worries. Several ``local.conf``
files are shared, for example [#]_. From my experience, you need a
files are shared, for example [#]_. From our experience, you need a
machine with two or four CPU core, 8 GB memory and 20 GB disk to run
DevStack comfortablely.
DevStack comfortablely. If you enable just major OpenStack projects,
the machine requirement would be much smaller like 2~4GB memory.
.. code-block:: console