Add project-config reviewing guidelines

As discussed at the OpenStack summit [1], document a few guidelines on
reviewing project-config changes.

The list is not exhaustive.

[1]
https://etherpad.openstack.org/p/newton-infra-proposal-jobs

Change-Id: I894782f0d7e69bc5385b30a940e21cfb49dcbe08
This commit is contained in:
Andreas Jaeger 2016-04-28 16:22:07 -05:00
parent b5d22d9a63
commit f204a7cac6
1 changed files with 68 additions and 0 deletions

68
REVIEWING.rst Normal file
View File

@ -0,0 +1,68 @@
========================
Reviewing project-config
========================
The following are notes for reviewers on how to review changes for
project-config. These notes are not exhaustive, they cover a few
caveats that especially core reviewers should be aware of.
Additional reviews
==================
For changes to projects, there should be support by the project team
that is affected. A couple of projects have listed infra liasons at
https://wiki.openstack.org/wiki/CrossProjectLiaisons#Infra . Changes
should only merge when at least one of the infra liasons has given a
+1. For not-listed projects, there are no rules but it might be good
to ask for review by PTL or cores of the repo depending on the change.
Voting jobs
===========
There should be no non-voting jobs in the gate queue. Voting jobs
should be in both check and gate queues.
New repo creations
==================
Check the following:
* If publishing to PyPI is set up: Check that
https://pypi.python.org/pypi/PROJECT exists and is set up for
openstackci.
* Is this a new repository for a team that is part of the Big Tent?
Then ask for a governance review and PTL+1.
* If there's no import ("upstream" keyword) of an existing repository,
best check that the team really wants to start with a new empty repo
and has no content to import. Either is fine, it's just that an
import at repo creation time is easy, afterwards it only causes
problems.
Big Tent resources
==================
Check that publishing to docs.openstack.org or specs.openstack.org is
only enabled for projects that are in the Big Tent (mentioned in
governance repository). Similary, translation workflow is also only
enabled for Big Tent projects.
Proposal jobs
=============
Proposal jobs run on the long running proposal slave that has access
to the credentials that the jobs need to access Zanata and gerrit.
Jobs running there are the exception and need to be carefully reviewed
before approving them.
Here are some points to look at:
* First response should be: How else can we achieve this?
* Jobs can publish artifacts also to specific places, like
static.openstack.org or tarballs.openstack.org, and use these from
other jobs.
* Proposal jobs should not run arbitrary scripts from other
repositories or install untrusted packages.