RETIRED, OpenStack I18n Specifications
Go to file
OpenDev Sysadmins 6b8cc9573d OpenDev Migration Patch
This commit was bulk generated and pushed by the OpenDev sysadmins
as a part of the Git hosting and code review systems migration
detailed in these mailing list posts:

http://lists.openstack.org/pipermail/openstack-discuss/2019-March/003603.html
http://lists.openstack.org/pipermail/openstack-discuss/2019-April/004920.html

Attempts have been made to correct repository namespaces and
hostnames based on simple pattern matching, but it's possible some
were updated incorrectly or missed entirely. Please reach out to us
via the contact information listed at https://opendev.org/ with any
questions you may have.
2019-04-19 19:36:29 +00:00
doc/source Create skeleton using cookiecutter 2016-11-29 23:45:44 +09:00
specs Create skeleton using cookiecutter 2016-11-29 23:45:44 +09:00
.gitignore Create skeleton using cookiecutter 2016-11-29 23:45:44 +09:00
.gitreview OpenDev Migration Patch 2019-04-19 19:36:29 +00:00
.mailmap Create skeleton using cookiecutter 2016-11-29 23:45:44 +09:00
.testr.conf Create skeleton using cookiecutter 2016-11-29 23:45:44 +09:00
.zuul.yaml import zuul job settings from project-config 2018-09-09 05:53:24 -04:00
CONTRIBUTING.rst Create skeleton using cookiecutter 2016-11-29 23:45:44 +09:00
LICENSE Create skeleton using cookiecutter 2016-11-29 23:45:44 +09:00
MANIFEST.in Create skeleton using cookiecutter 2016-11-29 23:45:44 +09:00
README.rst Add description in README with template 2016-12-21 00:45:50 +09:00
requirements.txt Create skeleton using cookiecutter 2016-11-29 23:45:44 +09:00
setup.cfg Create skeleton using cookiecutter 2016-11-29 23:45:44 +09:00
setup.py Create skeleton using cookiecutter 2016-11-29 23:45:44 +09:00
template.rst Add description in README with template 2016-12-21 00:45:50 +09:00
test-requirements.txt Create skeleton using cookiecutter 2016-11-29 23:45:44 +09:00
tox.ini fix tox python3 overrides 2018-09-26 18:36:52 -04:00

README.rst

Team and repository tags

image

OpenStack I18n Specifications

This git repository is used to keep track of design specifications with reviews and changes to the OpenStack I18n program. Reviews of the specs are done in gerrit, using a similar workflow to how we review and merge changes to openstack/i18n repository.

Expected Work Flow

  1. Create a blueprint in https://blueprints.launchpad.net/openstack-i18n with a task affecting the i18n-specs project.
  2. Propose a change to i18n-specs repository. You can find an example spec in /template.rst. Fill it and create a .rst file in /specs/ directory with the details of the new blueprint (ensure "Implements: blueprint [blueprint name]" is in the commit message).
  3. Review happens on proposal by i18n-core members and others.
  4. When ready for final approval, bring forward the proposed item to the i18n IRC meeting or mailing list: openstack-i18n@lists.openstack.org.

Once a specification is approved...

  1. Leave a comment to the git address of the specification on the blueprint.
  2. Indicate "Implements: blueprint [blueprint name]" on the commit messages for related implementations.

For i18n, blueprints are required for larger, cross- and coordinated projects but not for small translation fixes. It's a judgement call for whether you need a spec, so feel free to ask in the #openstack-i18n IRC channel or on the openstack-i18n mailing list.

Prior to the Ocata development cycle, this repository was not used for spec reviews. Reviews prior to Ocata were completed mainly through Launchpad blueprints.

Please note, Launchpad blueprints are still used for tracking the current status of blueprints. For more information, see https://wiki.openstack.org/wiki/Blueprints.

For more information about working with gerrit, see http://docs.openstack.org/infra/manual/developers.html#development-workflow.

To validate that the specification is syntactically correct (i.e. get more confidence in the Jenkins result), please execute the following command:

$ tox

After running tox, the documentation will be available for viewing in HTML format in the doc/build/ directory. Please do not check in the generated HTML files as a part of your commit.

The files are published at http://specs.openstack.org/openstack/i18n-specs.

The git repository is located at http://git.openstack.org/cgit/openstack/i18n-specs/.