system-config/doc/source/translate.rst
Monty Taylor 55ddc7bf88
Ectomy some Jenkins out of the docs
There are a bunch of places where the narrative text say things like
"jenkins runs jobs". This hasn't been true for a while and it's getting
less true.

Left third-party and running-your-own alone because those are
instructions for other people to do things - and we are not yet at the
point where we are suggesting anyone do their things like we do our
things.

The devstack-gate document describes an old deprecated system, but the
system is still in use (sadly) so it was mostly left intact. A warning
was added so that people would be clear that it was deprecated.

Also removed the logstash client config file. It's the only change in
here that actually affects running code and became unnecessary when it
was switched to geard with Ie3f814e6d3278d87f2a20a72e40b6b92217684fc

Change-Id: Iaf2128c3f953976180c71cb599fcbff7bc06c28a
2018-12-10 17:55:04 +00:00

56 lines
1.7 KiB
ReStructuredText

: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/
* :cgit_file:`modules/openstack_project/manifests/translate.pp`
* :cgit_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. Zuul proposes updates to translations with the
``upstream-translation-update`` and ``propose-translation-update`` jobs
defined in `project-config zuul jobs`_.
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`.
.. _project-config zuul jobs: http://git.openstack.org/cgit/openstack-infra/project-config/tree/zuul.d/jobs.yaml