6eef12125a
A new tag has been proposed in governance (see I34cdfe0e00cd29d816e94668ace2146d66734814 ) which asserts that a project follows OpenStack guidelines for an API maintaining compatibility over time. The original "Evaluating API Changes" guideline is used as the reference for what compatibility means. That guideline was copied from the wiki in May 2015 and the content that had been on the wiki last saw substantive change in August of 2012[1]. Under review it was discovered the guidance insufficiently robust in a situation where the primary goal is for there to be interoperability between clouds. A new set of guidelines on what signifies change or instability in an API is created in this document, with a new name, and with greater context on the reasoning. The old document has been updated to link to this new one with an explanation for why. [1] https://wiki.openstack.org/w/index.php?title=APIChangeGuidelines&action=history Change-Id: I0063c892cb1bddcca0745cd9f16b5004ff57959a
README
Openstack API Working Group documents
This repository contains documents from the OpenStack API working group, including guidelines and proposed rules concerning API consistency, naming conventions, and best practice recommendations. The published information can be found at specs.openstack.org.
Interested in contributing to the API conversations? Simply clone this repository and follow the OpenStack code and review submission processes and the process document.