Data and documentation maintained by the Interop Working Group
Go to file
Mark T. Voelker f477e97973 Move Governance/CoreDefinition into gerrit
At the April 8, 2015 DefCore Scale.11 meeting, the DefCore committee
decided to migrate some existing wiki artifacts into
gerrit.  This patch represents one such migration.  This patch
reproduces content previously housed at the following URL in RST
so that it can be placed more easily in source control:

https://wiki.openstack.org/wiki/Governance/CoreDefinition

Two minor formatting changes have been made to best accommodate the
new RST format:

1. The page title has changed from the old wiki-enforced heading
   "Governance/CoreDefinition" to the more plain-English equivalent
   "Core Definition".  Aside from this change, the text of the document
   is completely unaltered from it's state in the wiki on the day this
   patch was submitted.

2. The placement of the principles image has changed.  It is now
   placed at the top of the Principles section instead of alongside
   the first two principles in the list in order to accommodate those
   reading the RST as raw/unrendered plaintext.

Change-Id: I5aac99478981253e51f68605b5473175fc313eb3
2015-04-09 15:39:55 -04:00
drafts Complete Havana capabilities as passed by the Board in July 2014 2014-08-23 08:19:41 -05:00
images Move Governance/CoreDefinition into gerrit 2015-04-09 15:39:55 -04:00
js Add GET test results and add report page output 2015-01-20 13:54:38 -08:00
legacy Initial draft of 2015.03 guideline 2015-03-13 09:21:12 -07:00
process Consensus changes from DefCore Scale.10B meeting 2015-04-07 15:46:27 -04:00
.gitreview Initial draft of 2015.03 guideline 2015-03-13 09:21:12 -07:00
2015.03.json Merge "Flag tests that require SSH" 2015-04-08 03:17:25 +00:00
2015.03.rst Minor RST Format and xref fix 2015-03-30 21:41:44 -07:00
2015.04.json Add project names to capabilities for RST generator 2015-04-06 14:27:17 -05:00
2015.04.rst DefCore 2015.04 Guideline Approved by Board April 2nd 2015-04-03 06:52:51 -07:00
2015.next.json Add project names to capabilities for RST generator 2015-04-06 14:27:17 -05:00
2015.next.rst DefCore 2015.04 Guideline Approved by Board April 2nd 2015-04-03 06:52:51 -07:00
CoreDefinition.rst Move Governance/CoreDefinition into gerrit 2015-04-09 15:39:55 -04:00
lexicon.rst Correct missing linebreak 2015-04-07 15:21:26 -04:00
README.rst Minor RST Format and xref fix 2015-03-30 21:41:44 -07: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 Flow

see /process/2015A.rst or later

Terminology

see lexicon.rst

JSON Schema

The JSON files have a specific schema to support

{ "id": "2015.03",        # Spec name (date based)
  "schema": "1.1",        # Schema version
  "status": "approved",   # can be draft, review or approved
  "replaces": "2014.07",  # previous spec
  "releases": ["icehouse"], # array of releases, lower case
  "platform": {           # platform components
    "required": ["compute", "object"],  # array
    "advisory": [],       # incoming array
    "depricated": [],     # outgoing array
    "removed": []         # removed array
    },
  "components": {         # components detail
    "compute": {          # component name
      "required": [       # required array
        "compute-auth"],
      "advisory": [       # incoming array
        "compute-servers-metadata"],
      "deprecated": [],   # outgoing array
      "removed": [        # removed array
        "volume"]
      },
    },
  "criteria" : {          # explains achievements
      "atomic" : { "Description" : "blah blah blah",
      "name" : "Atomic", 
      "weight": 8
      },
  "capabilities": {       # capabilities listed in components
    "example-cap" :       # capability
      { "achievements" :  # array of criteria met
        [ "deployed",
          "future",
          "complete"],
      "admin" : false,    # is admin API
      "status" : "required",  # de-normalized from components
      "description" : "Helpful Description",
      "flagged" : [  ],   # flagged tests array
      "name" : "Friendly Short Name",
      "tests" :           # list of tests (please use UUIDs)
        [ "tempest.api.project.file.class.test_name" ]
    },