At the Board of Directors meeting on April 24, 2016 the Board of
Directors indicated that as DefCore has evolved it's focus on
interoperability and it's working structure, it's name may be a source
of some confusion to those outside of the community or who are new to
the community. The Board made an informal request that the DefCore
Committee consider changing it's name to more clearly reflect it's focus
and structure.
This patch is the first step in that process. It updates references
in various documents to change the name "DefCore Committee" to
"Interop Working Group" as agreed at the summer 2016 DefCore Committee
Sprint [1].
It should be noted that this patch should be considered a work in
progress to generate discussion until the new name is approved by
the DefCore Committee and the Board of Directors. Should we elect
to go forward with the new name, some other actions will also need
to be taken, including but not limited to:
1. We will need to consider updating references on the OpenStack wiki.
2. We will need to consider updating the name of our IRC channel,
mailing list, Launchpad project, and git repository. Most of these
changes will need to be carefully coordinated with the OpenStack
Infrastructure team.
3. We will need to take into account external resources that point to
DefCore artifacts, such as Foundation-maintained websites (such as:
http://www.openstack.org/interop ).
4. We will need to coordinate with RefStack to minimize impact.
5. We will need to clearly communicate the name change to the rest of the
community.
Note also that I've intentionally left many historical documents that
have been superceded (such as the 2015A process docs, Guidelines that
are no longer used, etc) in tact. There seemed little value in
spending time on them and cluttering the patch with them since they're
now obsolete.
[1] https://etherpad.openstack.org/p/DefCoreSummer2016Sprint
Change-Id: I79d337c193e75c54d49f1d847468f6347e2ef2b3
As we add more and more Guidelines over time, the top-level
directory of the defcore repo is becoming increasingly cluttered.
Further, each Guideline includes an RST file that could be
rendered on docs.openstack.org and/or gate-checked for validity
like other RST documents. This patch moves the Guideline docs
into a dedicated folder in the doc directory using a structure
akin to that of the process docs that already reside there. [1][2]
It also cleans up a few references to documents already in the
doc directory that were missed earlier, and adds a note to the
README indicating what the doc/sources/guidelines directory
contains.
Note that a few links on http://openstack.org/interop and DefCore
wiki pages may need to be updated if/when this change lands. It
is therefore suggested that this patch be merged only when the
relevant Foundation staff are prepared to make corresponding
updates to the website in order to avoid broken links.
[1] https://review.openstack.org/#/c/189950/
[2] https://review.openstack.org/#/c/189956/
Change-Id: Iddd8a4c191c490f4b0afb8c88c8520da4b97576b
Updated tox.ini to check current rst documents. Fixed tox errors
in checked documents. Semantics of docments remained unchanged
Change-Id: Ic4b628b551e0c438ca71d5728afa7172bc3cf128
Upon review, we found that we do NOT need breaking changes to the
schema. In this minor revision, we are adding keys and placing
forward references to the new keys from the old ones.
At this point, we've removed the tests as per 2015.05 guideline.
These will be added back over time.
SUMMARY:
added: reference
added: tests-repositories
added: required-since
added: tests now have block including idempotent_id and (optional) flagged information
change: guidelines to point to required-since
change: tests from array to hash
change: add hash after test-name keys
change: flagged points to new location tests/test-name/flagged
change: new version 1.3
To match the reference field, added new schema.1.3.rst file with
explanation of the json schema. This file was expanded to include
items that were added in 1.2 but not documented.
The schema.1.2.rst file was added to preserve the json schema
removed from the README.rst file. It was not otherwise changed.
Expanded HACKING file to capture flagging mechanics.
Co-Authored-By: Rob Hirschfeld <rob@zehicle.com>
Co-Authored-By: Chris Hoge <chris@openstack.org>
Co-Authored-By: Mark T. Voelker <mvoelker@vmware.com>
Change-Id: I61483f988bdb1f4deb18266f611044b24ba65c34
And update the readme to point to those docs.
Replaces an earlier patch for housekeeping with merge issues.
Change-Id: Ie8fba36b9033531d5ff90cde4e55631746116a14
This is a minor correctio to the RST format so
that we correctly render the FORMAT information
at the bottom of the file.
I also fixed the cross references in the
readme file.
Change-Id: I587c2132df7622115207810083256bfc6d2184ea
Initial draft of 2015.03 guideline as passed by the board.
We are condensing two steps into one here > format & content.
After we accept this, we will create a new prelim guideline for
the next review cycle (target at 2015.04!).
I've also moved from files out of the root directory for
cleanup.
The RST and JSON files should match in content.
Change-Id: I40623b38e80a7d4a65a66d7210f6dfad5835c371
This change includes capabilities descriptions from Troy,
Sergey, Julia & Rocky.
PLEASE DO NOT ASK FOR DESCRIPTION OR NAME CHANGES...
+1 the file and then submit patches against it
we know that the tests, names and descriptions are incomplete.
The tests are NOT included in the capabilities because more
review is needed. We expect that they will be updated
after the schema with capabilities are approved.
Change-Id: I81016dbb25bf421723e89f2e2a2b21466d461605
The driver file in this pull are placeholders
for the actual content in the files.
In the case of the coretests and capabilities list,
preliminary values have been provided for discussion
and review of the schema.
** THEY ARE NOT OFFICIAL RESULTS **
These files will contain approved information that
is managed by the DefCore committee relating to
core and driver test.
For more information about this process please
review https://wiki.openstack.org/wiki/Governance/CoreCriteria
and Rob Hirschfeld's post: http://robhirschfeld.com/tag/defcore/
Changes to these files must be +1 by a DefCore chair.
Change-Id: I7ebc6f482f062725ce2cdb83a5102eaba05d8cfe