governance/reference/tag-template.rst
Doug Hellmann 72b8b9a74d Build list of teams from YAML file
Render the YAML file contents as the list of official teams and create a
directive to render the list of projects with a given tag to avoid
having to update that data in two places.

Change-Id: I7c6effe6e440f2147f8c68df090152e716c38fba
2015-02-24 18:15:04 -05:00

3.2 KiB

This work is licensed under a Creative Commons Attribution 3.0
Unported License.
http://creativecommons.org/licenses/by/3.0/legalcode

proposed-tag-name (should match the tags/proposed-tag-name.rst filename)

Introduction paragraph -- a short summary of what this tag will mean.

Rationale

The detailed reason why the OpenStack ecosystem benefits from having this tag defined.

Requirements

  • A list of requirements for granting the tag to an existing project.
  • All the criteria should be objective and predictable.
  • If a tag requires another tag, this should be mentioned here.

Tag application process

Details of the process to follow to maintain the tag. Are additions/removals regularly reviewed, or are they considered only upon request ? Which group is involved, and at which frequency ?

The process may include requiring feedback from specific groups, delegation of tag maintenance from the TC, minimum delays between application and tag grant, timeframes where granting or removing the tag is appropriate, etc.

If the grant process is different from the removal process, this should also be mentioned here.

By default, you can use the following process:

Anyone may propose adding or removing this tag to a set of projects by proposing a change to the openstack/governance repository. The change is reviewed by the Technical Committee and approved using standard resolution approval rules, including discussion at at least one Technical Committee public IRC meeting.

Deprecation

Some tags may have a deprecation period (where a project retains the tag but only until a certain announced date). If the proposed tag has a deprecation period, its duration (and any other specific rules) should be listed here.

Attributes

Tags may have attributes which provide extra information. Those attributes (and their values) should be described in this section.

example-attribute

Description of the example-attribute tag attribute, and of the values it may take.

Application to current projects

As part of the application you need to go through the exercise of applying the proposed tag to at least some subset of the current project list. This will serve as an example of how the tag should be applied in the real world. You may also submit (as a subsequent change) the corresponding governance change to immediately apply the proposed tag to projects.

<tag name>