Commit Graph

20 Commits

Author SHA1 Message Date
Lee Yarwood c6a399f453 doc: Separate the releasenotes guide from the code-review section
This was previously hidden within the code review guide making it almost
impossible to find from the initial index page.

Change-Id: I47e771c641d72a837345b1b9a07e86ca4313b518
2017-04-03 22:02:59 +00:00
Emilien Macchi 26826bc686 Document experimental pipeline in Nova CI
Add a section in "core-review" to document how experimental pipeline would
be used by Nova developers in order to consume the resources at the
right time.

Change-Id: I5df377032c2fcec18cdf71af2568e028373bcced
2016-10-13 11:40:30 -04:00
Jenkins c7a8cf3785 Merge "doc: Comment on latin1 vs utf8 charsets" 2016-10-12 10:19:03 +00:00
Stephen Finucane 608a01e65e doc: Comment on latin1 vs utf8 charsets
Change-Id: Ia50ea5cfd631fac8edb27e040cde91826a3c4182
2016-10-11 15:15:45 +01:00
Markus Zoeller c1a30f85d6 docs: update code-review guide for config options
We recently came to the conclusion that the original idea how the
config options of Nova should be documented are too hard to maintain.
The discussion can be found on the ML starting with:
http://lists.openstack.org/pipermail/openstack-dev/2016-May/095538.html

This change reflects the outcome of the discussion.

Change-Id: I27b2cbb663f3c9a8c2503c3148280a3844f69cdd
2016-08-09 17:35:55 +02:00
Matt Riedemann 45b21e4503 Add docs about microversion testing in Tempest
As discussed at the newton midcycle and in the dev
mailing list:

http://lists.openstack.org/pipermail/openstack-dev/2016-July/099860.html

We should add a Tempest test for any microversion that
changes the response schema so we have coverage in Tempest
and also so we don't have to fill large gaps in coverage
in Tempest when adding other unrelated tests.

Change-Id: Ie7cfe7ee857caf630d4380cf673ae208842fbc00
2016-07-28 20:09:07 -04:00
jichenjc a90488ed31 Not talking about V2 API code in review doc guide
V2 code is gone , there is no need to talk about this
in our document any more.

Partially implements blueprint remove-legacy-v2-api-code

Change-Id: Ibca00e3e862c1487f0a440fdcc7d11d09026c7a8
2016-05-07 02:40:21 +08:00
Matt Riedemann a61219721a Document our policy on fixing v2.0 API bugs
There was recent discussion in some reviews about fixing
latent bugs in the legacy v2.0 API code. Since the
v2.0 API is deprecated and v2.1 is the default since Liberty,
we shouldn't need to fix latent low-priority bugs in v2.0
anymore.

However, we'll still fix critical bugs, and we shouldn't
knowingly introduce new regressions that would result
in a 500 response.

Change-Id: I9937d9226a99754dadcc48d599090296f5ae01f7
2016-04-05 19:58:07 -04:00
Balazs Gibizer 028ff49b2a doc:Ask reviews to reject new legacy notifications
The versioned notificaton infrastructure is in place and the team
agreed on the midcycle to allow new notification types only based
on the versioned notification infrastructure. So the code-review
document is updated to reflect this decision

Change-Id: I7f3860ca59658dc21e67f26bb45341cb46da2235
Partially-Implements: bp versioned-notification-api
2016-01-28 15:36:17 +01:00
Ken'ichi Ohmichi 070c2e659b Add reviewing point related to REST API
Since I8ad9313f824ef656c841a9b60ee575f02ddea321, the api-wg has
introduced a new guideline. That was based on Nova's development
experience, and this patch adds it as a reviewing point for making
consistent APIs.

Change-Id: I53c4055d973b6f76fca16ae170d0df9e1829fca5
2016-01-13 02:54:46 +00:00
Alexis Lee 1a3633ef88 Fix advice for new contribs
The trivial bug list has already got a +1 and often the fixes there are
too trivial to learn very much. Replaced with some hopefully more
useful advice.

Change-Id: Ibf5abc4dca170770d302ae9276312faad5eabdb6
2016-01-06 14:27:24 +00:00
Markus Zoeller 1867ff8ba8 review guide: add location details for config options
With blueprint centralize-config-options we came to a conclusion
that it makes sense to have all config options at one central place.
This patch enhances the "config options" section with a "location"
subsection to clarify this.

Change-Id: I48b6f0c3311ad75f9faef78a7d163ae5bf640c6c
2015-12-18 15:10:55 +01:00
Jenkins e266f24bc4 Merge "Add review guideline to microversion API" 2015-12-08 22:01:14 +00:00
Jenkins 23fc697abd Merge "Add reviewing point related to REST API" 2015-12-08 17:55:34 +00:00
Ken'ichi Ohmichi 56e953c6eb Add reviewing point related to REST API
During nova-specs/nova reviews, it is difficult to check all API changes
for following api-wg guideline because there is a lot of nova-specs/nova
patches. There are some common mistakes against following guideline,
then this patch adds a part of the guideline to the code-review guideline
for avoiding these mistakes.

Change-Id: I2192e9ffd3026057dc01006bd0ba419140c5b5b0
2015-12-06 04:31:56 +00:00
John Garbutt 49809ba197 docs: ensure third party tests pass before +2
Adds a note to the code review guidelines to make sure appropriate third
party tests are passing before giving a change a +2 vote.

Change-Id: I42501d3996a2751b69803e37451cc0544ad75ce8
2015-12-04 11:35:30 +00:00
Sylvain Bauza b169fd1d32 Add code-review devref for release notes
Now that we use reno, we need to provide some docs for explaining when
to provide a reno file.

Change-Id: Iebdbdad11986726aeebbf8fdc27e8dbe0bffb299
2015-11-24 21:59:01 +01:00
jichenjc bcd78caaf5 Add review guideline to microversion API
Python-novaclient need to be updated to address new microversion
API change , so add some suggestions in the doc.

Change-Id: Ibb2d137a6a16badea7c2619d210317b7a098ec4e
2015-11-24 15:47:40 +08:00
Markus Zoeller 71fb6389a6 code-review guidelines: add checklist for config options
The code-review guidelines document should be a somewhat agreed list
of what to consider when doing a review. This patch set adds the
items to check if the review contains changes which involves config
options.

Change-Id: I142ab25fa7fc1c4ece5a68f68c5d841c797af1be
2015-10-09 13:24:12 -07:00
Dan Smith b07162a4b2 Add a code-review guideline document
This adds a document that aims to provide a checklist-like review
guideline for code reviewers. We can encode small decisions and tribal
knowledge in this document to help increase consistency.

Right now, this just adds upgrade-related review items as those are
some of the more complicated and least-documented at the moment.

Change-Id: I5bbb7e4e2192b853373fed38ca0ad873fc8b329e
2015-10-09 13:23:56 -07:00