Merge "Initial documentation commit for Zanata"

This commit is contained in:
Jenkins 2015-09-25 09:17:55 +00:00 committed by Gerrit Code Review
commit 22361b23ad
2 changed files with 52 additions and 0 deletions

View File

@ -33,6 +33,7 @@ Major Systems
afs
askbot
apps_site
translate
.. NOTE(dhellmann): These projects were not listed above, or in any
other toctree, which breaks the build. It's not clear why they were

51
doc/source/translate.rst Normal file
View File

@ -0,0 +1,51 @@
:title: Translate
.. _translate:
Translate
#########
As of the Liberty release, translations for various projects in OpenStack are
done on the Zanata translations platform.
At a Glance
===========
:Hosts:
* https://translate.openstack.org
* https://translate-dev.openstack.org
:Puppet:
* https://git.openstack.org/cgit/openstack-infra/puppet-zanata/tree/
* :file:`modules/openstack_project/manifests/translate.pp`
* :file:`modules/openstack_project/manifests/translate-dev.pp`
:Projects:
* http://zanata.org/
* https://github.com/zanata/
:Bugs:
* https://zanata.atlassian.net/projects/ZNTA/issues/
Overview
========
The OpenStack Infrastructure runs a production instance and a development
instance of Zanata running on the `Wildfly JBoss Application Server
<http://wildfly.org/>`_. Upgrades must be tested on the development server
before being applied in production.
Translators work through the Zanata web UI or with the zanata-cli tool to do
their translations. A series of Jenkins jobs handle translations proposals
on the proposal slave.
Projects are added for translations by
modifying :config:`gerrit/projects.yaml` and adding the following to
the project::
options:
- translate
Projects are then registered with Zanata with the register-zanata-projects.py
from :ref:`jeepyb`, this is run when :config:`gerrit/projects.yaml`
changes.
Finally, the translations jobs must be added to the project in
:config:`jenkins/jobs/projects.yaml` and :config:`zuul/layout.yaml`.