751551bf0a
In the DefCore Scale cycle, we moved some older process documents out of the OpenStack wiki and into Gerrit in order to more easily maintain them. The original imports were largely a "lift and shift" of the wiki text, with improvements and cleanups to be driven later. The Governance Process document in particular is quite dated and contains information that has changed substantially over time. This patch attempts to clean it up by modfiying it to reflect current reality while also maintaing some flexibility for the future. For example, we haven't used Google Hangouts for meetings in many months, so the patch simply states that meetings will be open and the means to join them will be posted on the wiki and/or mailing list (thus allowing us to use other collaboration tools in the future without needing to ammend process). Change-Id: I4159c24fc3283fd8baa15f98bd2a59b1e9b1fcdb
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
The /process directory contains details about the DefCore process.
- Core Definition
-
process/CoreDefinition.rst
- Process Goverance
-
process/2015A.rst (please check for latest)
- Designated Sections
-
process/DesignatedSections.rst
- Core Criteria
-
process/CoreCriteria.rst
- DefCore Governance
-
process/GovernanceProcess.rst
- Platform and Components
-
process/PlatformCap.rst
- DefCore Cycles
-
process/ProcessCycles.rst
- Terminology
-
process/Lexicon.rst
JSON Schema
The JSON files have a specific schema to support
{ "id": "2015.03", # Spec name (date based)
"source": "http://git.openstack.org/cgit/openstack/defcore/", # git repo for files
"schema": "1.2", # 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" ]
},