Mark T. Voelker 35d8985013 Add Guidance on Modifying Tests, Filing Flags
It's now come up a couple of times that we've found people modifying
tests in order to pass them.  Although seems obvious that not testing
things the same way across all clouds voids any guarantee of
interoperability, we should make this explit in the guidance we provide.
It's been proposed that one reason folks may be modifying tests is that
they don't clearly understand what they need to do in order to file a
flag request when they run into a problem, so they try to fix what they
think is wrong with the test instead.

This patch makes three changes to help address the issue:

1.) It adds a section to the 2016.01 guidance (which is currently
linked to from http://openstack.org/interop) to make it explicitly
clear that tests shouldn't be modified.

2.) Assuming that the interop website will be updated to point to the
most recent Guideline at some point, it creates the same guidance for
2016.08.

3.) It ammends HACKING to include simple instructions and an example
of how to file a flag request.  The individual guidelines' guidance
files also point to HACKING so folks know to look there.

Change-Id: I2f57a852da3181714e87d8e689dd5a1cb33cb417
2016-10-07 00:39:58 -04:00
2015-03-13 09:21:12 -07:00
2015-03-13 09:21:12 -07:00
2016-01-05 15:03:43 -08:00

Understanding the DefCore Guidelines

This repository contains DefCore committee managed files that provide guidance for the OpenStack community.

NOTE: Changes to file requires approval of the DefCore committee chair(s).

DefCore Process Documentation

Want to certify as a vendor? Consult OpenStack Interop.

The /doc/source/process directory contains details about the DefCore process.

The /doc/source/schema directory contains details about the JSON schema versions used to express Guidelines.

The /doc/source/guidelines directory contains RST versions of the DefCore Guidelines approved by the OpenStack Board of Directors.

Core Definition

doc/source/process/CoreDefinition.rst

Process Goverance

doc/source/process/2015A.rst (please check for latest)

Designated Sections

doc/source/process/DesignatedSections.rst

Core Criteria

doc/source/process/CoreCriteria.rst

DefCore Governance

doc/source/process/GovernanceProcess.rst

Platform and Components

doc/source/process/PlatformCap.rst

DefCore Cycles

doc/source/process/ProcessCycles.rst

Terminology

doc/source/process/Lexicon.rst

Description
Data and documentation maintained by the Interop Working Group
Readme 7.3 MiB
Languages
Python 61.3%
Shell 23.3%
JavaScript 10.7%
HTML 4.7%