openstack
/
i18n-specs
Code Issues Proposed changes
RETIRED, OpenStack I18n Specifications
4 Commits 1 Branch 0 Tags 98 KiB
Go to file
Doug Hellmann b364cdc660 import zuul job settings from project-config 
This is a mechanically generated patch to complete step 1 of moving
the zuul job settings out of project-config and into each project
repository.

Because there will be a separate patch on each branch, the branch
specifiers for branch-specific jobs have been removed.

Because this patch is generated by a script, there may be some
cosmetic changes to the layout of the YAML file(s) as the contents are
normalized.

See the python3-first goal document for details:
https://governance.openstack.org/tc/goals/stein/python3-first.html

Change-Id: I8d3f6cc16f6dde6f92ba8a911dabc6b9ff0be345
Story: #2002586
Task: #24300
 		2018-09-09 05:53:24 -04: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 Added .gitreview 2016-11-09 09:12:43 +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 Create skeleton using cookiecutter 2016-11-29 23:45:44 +09: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/.