Greetings OpenStack community, Today's meeting was brief, primarily focused on planning for the summit sessions[7][8] that the SIG will host and facilitate.
The first session[7], will be a Birds of a Feather (BoF) gathering where the topics will be determined by the attendees. One topic that will surely make that list is the GraphQL proof of concept for Neutron that has been discussed on the mailing list[9]. The second session[8], will be a directed discussion addressing technical debt in the REST APIs of OpenStack. We're now at the point where people would like to start removing old code. This session will give interested parties details about how they can leverage microversions and the guidelines of the SIG to reduce their debt, drop old functionality, and improve the consistency of their APIs. It will also clarify what it means when we bump the minimum microversion for a service in the future and discuss plans for creating an OpenStack community goal. For both sessions, the SIG has aligned itself towards helping coordinate discussions, clear up misunderstandings, and generally be helpful in ensuring that all voices are heard and cross-cutting concerns are addressed. If you are heading to summit, we hope to see you there! There being no recent changes to pending guidelines nor to bugs, we ended the meeting early. As always if you're interested in helping out, in addition to coming to the meetings, there's also: * The list of bugs [5] indicates several missing or incomplete guidelines. * The existing guidelines [2] always need refreshing to account for changes over time. If you find something that's not quite right, submit a patch [6] to fix it. * Have you done something for which you think guidance would have made things easier but couldn't find any? Submit a patch and help others [6]. # Newly Published Guidelines None # API Guidelines Proposed for Freeze Guidelines that are ready for wider review by the whole community. None # Guidelines Currently Under Review [3] * Update parameter names in microversion sdk spec https://review.openstack.org/#/c/557773/ * Add API-schema guide (still being defined) https://review.openstack.org/#/c/524467/ * 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) https://review.openstack.org/444892 # Highlighting your API impacting issues If you seek further review and insight from the API SIG about APIs that you are developing or changing, please address your concerns in an email to the OpenStack developer mailing list[1] 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 SIG mission and the work we do, see our wiki page [4] and guidelines [2]. Thanks for reading and see you next week! # References [1] http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev [2] http://specs.openstack.org/openstack/api-wg/ [3] https://review.openstack.org/#/q/status:open+project:openstack/api-wg,n,z [4] https://wiki.openstack.org/wiki/API_SIG [5] https://bugs.launchpad.net/openstack-api-wg [6] https://git.openstack.org/cgit/openstack/api-wg [7] https://www.openstack.org/summit/vancouver-2018/summit-schedule/events/21798/api-special-interest-group-session [8] https://www.openstack.org/summit/vancouver-2018/summit-schedule/events/21881/api-debt-cleanup [9] http://lists.openstack.org/pipermail/openstack-dev/2018-May/130219.html Meeting Agenda https://wiki.openstack.org/wiki/Meetings/API-SIG#Agenda Past Meeting Records http://eavesdrop.openstack.org/meetings/api_sig/ Open Bugs https://bugs.launchpad.net/openstack-api-wg __________________________________________________________________________ OpenStack Development Mailing List (not for usage questions) Unsubscribe: openstack-dev-requ...@lists.openstack.org?subject:unsubscribe http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev