[openstack-dev] [all][api] POST /api-sig/news
cdent+os at anticdent.org
Thu Aug 24 16:54:57 UTC 2017
Greetings OpenStack community,
Two main topics this week: Getting ready for the PTG and speculating about standards for representing singular resources in an HTTP response.
The API-SIG will have a room on Monday and Tuesday at the PTG. In addition to the guided review process  we've mentioned before, there's an etherpad  where an agenda of potential topics is being built. We'll likely be sharing some of the time with people interested in SDKs and other issues related to consuming APIs. If there are gaps we will strenuously but politely argue about strong types in HTTP APIs and the subtle nature of microversions.
The discussion about singular resources relates to a placeholder bug  for a guideline that we need to write. There are at least two different styles in use within OpenStack already, neither of which align with some emerging standards. The bug links to some of the discussion. Please feel free to provide your opinion if you have one.
# Newly Published Guidelines
None this week.
# API Guidelines Proposed for Freeze
Guidelines that are ready for wider review by the whole community.
None this week
# Guidelines Currently Under Review 
* Explain, simply, why extensions are bad
* A (shrinking) suite of several documents about doing version and service discovery
Start at https://review.openstack.org/#/c/459405/
* WIP: microversion architecture archival doc (very early; not yet ready for review)
# Highlighting your API impacting issues
If you seek further review and insight from the API WG, please address your concerns in an email to the OpenStack developer mailing list with the tag "[api]" in the subject. In your email, you should include any relevant reviews, links, and comments to help guide the discussion of the specific challenge you are facing.
To learn more about the API WG mission and the work we do, see OpenStack API Working Group .
Thanks for reading and see you next week!
Past Meeting Records
Chris Dent (⊙＿⊙') https://anticdent.org/
freenode: cdent tw: @anticdent
More information about the OpenStack-dev