From 28db41694b8ce61bdaabbf7e20a3bcd429f075c6 Mon Sep 17 00:00:00 2001
From: "Elizabeth K. Joseph" <lyz@princessleia.com>
Date: Thu, 10 Sep 2015 11:27:37 -0700
Subject: [PATCH] Initial documentation commit for Zanata

Basic details and links for our Zanata deployment for translations.

Change-Id: Idc4e8f2f9c3b456f638231511c6bf3d68773a482
---
 doc/source/systems.rst   |  1 +
 doc/source/translate.rst | 51 ++++++++++++++++++++++++++++++++++++++++
 2 files changed, 52 insertions(+)
 create mode 100644 doc/source/translate.rst

diff --git a/doc/source/systems.rst b/doc/source/systems.rst
index b1c0f1f9e1..7c3271320c 100644
--- a/doc/source/systems.rst
+++ b/doc/source/systems.rst
@@ -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
diff --git a/doc/source/translate.rst b/doc/source/translate.rst
new file mode 100644
index 0000000000..be51fa7067
--- /dev/null
+++ b/doc/source/translate.rst
@@ -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`.