16:00:20 <edleafe> #startmeeting api-wg
16:00:20 <openstack> Meeting started Thu Jan 19 16:00:20 2017 UTC and is due to finish in 60 minutes.  The chair is edleafe. Information about MeetBot at http://wiki.debian.org/MeetBot.
16:00:22 <openstack> Useful Commands: #action #agreed #help #info #idea #link #topic #startvote.
16:00:24 <openstack> The meeting name has been set to 'api_wg'
16:00:32 <edleafe> #chair cdent elmiko etoews edleafe
16:00:32 <openstack> Warning: Nick not in channel: cdent
16:00:33 <openstack> Current chairs: cdent edleafe elmiko etoews
16:00:36 <edleafe> #link https://wiki.openstack.org/wiki/Meetings/API-WG#Agenda
16:00:51 <edleafe> So who's here today?
16:02:02 * edleafe is starting to feel lonely...
16:02:38 <elmiko> yo
16:02:46 <gouthamr> hi
16:03:03 <elmiko> sorry, got caught looking at code ;)
16:03:12 <edleafe> Ah! some signs of life! :)
16:03:35 <edleafe> Well, let's get started. Maybe this will be a quick meeting
16:03:45 <edleafe> #topic previous meeting action items
16:03:47 <elmiko> could be
16:03:50 <edleafe> #link http://eavesdrop.openstack.org/meetings/api_wg/2017/
16:04:08 <edleafe> There were 2 items last week:
16:04:11 <edleafe> edleafe, scottda, mordred to drive some dicussion about api versioning at ptg
16:04:22 <edleafe> Added the topic to the Architecture Workgroups PTG etherpad: https://etherpad.openstack.org/p/ptg-architecture-workgroup
16:04:35 <edleafe> Please add your names to that page if you plan on attending the discussion
16:04:45 <scottda> Hi. Yup I sent a ML post on that
16:05:23 <edleafe> scottda: ah, I was just going to add:
16:05:29 <edleafe> Second: scottda to send out email to get things started for consistent versioned endpoints
16:05:37 <edleafe> #link http://lists.openstack.org/pipermail/openstack-dev/2017-January/110043.html
16:05:52 <edleafe> So it looks like we're good on those
16:05:59 * gouthamr didn't reply to scottda's email but will definitely join
16:06:26 <edleafe> Cool; thanks gouthamr
16:06:34 <edleafe> #topic open mic and new biz
16:07:09 <edleafe> cdent posted a thing in response to the TC's discussion on "Updating stability/compatibility guidelines"
16:07:23 <edleafe> #link http://lists.openstack.org/pipermail/openstack-dev/2017-January/110384.html
16:07:52 <edleafe> And the review that people should comment on / tear apart:
16:07:54 <edleafe> #link https://review.openstack.org/#/c/421846/
16:08:17 <edleafe> Chris comments: "I wanted to be sure that the guideline got a rewrite to express that goal zero is to make users happy and that trumps everything"
16:08:46 <edleafe> So please read the email, and add your thoughts to the review
16:09:03 <edleafe> #topic guidelines
16:09:11 <edleafe> #link https://review.openstack.org/#/q/status:open+project:openstack/api-wg,n,z
16:09:26 <edleafe> Accurate status code vs. Backwards compatibility
16:09:28 <edleafe> #link https://review.openstack.org/#/c/422264/
16:09:45 <edleafe> This is clarifying that changing a returned status code is an API change
16:09:57 <edleafe> It's new, so not a lot of discussion on it yet
16:10:05 <rosmaita> it's an offshoot of a glance patch, https://review.openstack.org/#/c/420038/
16:10:12 <edleafe> Clarifying that changing a returned status code is an API change
16:10:32 <edleafe> rosmaita: yes, thanks
16:10:55 * edleafe has to get his copy/paste working better
16:11:08 <mordred> ++ to clarification
16:11:16 <edleafe> fix no sample file in browser
16:11:17 <edleafe> #link https://review.openstack.org/#/c/421084/
16:11:27 <edleafe> Some concern whether this is needed, or just a GitHub artifact
16:11:49 <edleafe> Define pagination guidelines
16:11:50 <edleafe> #link https://review.openstack.org/#/c/390973/
16:12:03 <edleafe> Getting closer... please review comments on the 'last' link language
16:12:15 <edleafe> Once that's settled, I think it's good to go
16:12:26 <edleafe> Add API capabilities discovery guideline
16:12:27 <edleafe> #link https://review.openstack.org/#/c/386555/
16:12:33 <edleafe> Still no consensus on what this is supposed to be doing.
16:13:03 <edleafe> In general, should this always be scoped to the user? And should it take into account the state of the resource?
16:13:39 <edleafe> So if you have an opinion on this, please add it to the review
16:13:48 <edleafe> Removes unnecessary utf-8 encoding
16:13:48 <edleafe> #link https://review.openstack.org/#/c/414782/
16:14:04 <elmiko> that discussion on capabilities is daunting, to say the least
16:14:13 <edleafe> This is a no-brainer. Unless there is objection, I will just merge it.
16:14:23 <edleafe> elmiko: agreed.
16:14:25 <mordred> ++
16:14:34 <edleafe> elmiko: I don't think we are all using the word in the same way
16:14:46 <elmiko> edleafe: agreed
16:14:56 <elmiko> +1 on the utf-8 merge too
16:15:14 <edleafe> Add guidelines for boolean names
16:15:15 <edleafe> #link https://review.openstack.org/#/c/411529/
16:15:22 <edleafe> Please weigh in on your preferences for naming: 'enabled' vs. 'is_enabled', etc.
16:16:23 <edleafe> As I mentioned to mordred yesterday, these guidelines were culled from a quick review of code in several projects, and are meant to be strawmen for people to beat up on
16:16:49 <edleafe> So get out your sticks and pound away! :)
16:17:26 * mordred has hit with sticks alread! :)
16:17:50 * edleafe knows that mordred can hit much harder
16:18:15 <edleafe> The following guidelines seem to have no issues, and should be ready for freeze
16:18:30 <edleafe> Clarify the status values in versions
16:18:30 <edleafe> #link https://review.openstack.org/#/c/411849/
16:18:30 <edleafe> Add guideline for invalid query parameters
16:18:30 <edleafe> #link https://review.openstack.org/#/c/417441/
16:18:30 <edleafe> Add guidelines on usage of state vs. status
16:18:32 <edleafe> #link https://review.openstack.org/#/c/411528/
16:19:09 <edleafe> Please give those a review, and unless an issue surfaces, they will be frozen for general review
16:19:52 <edleafe> #topic bug review
16:19:54 <edleafe> #link https://bugs.launchpad.net/openstack-api-wg
16:20:26 <edleafe> Most are guideline/doc omissions, so if you have the time, that's a great way to contribute
16:20:33 <elmiko> +1
16:21:17 <edleafe> #topic weekly newsletter
16:21:18 <edleafe> #link https://etherpad.openstack.org/p/api-wg-newsletter
16:21:33 <edleafe> Since cdent is on PTO, anyone want to volunteer to do this?
16:21:57 * elmiko looks around nervously
16:22:39 <edleafe> elmiko: If not, I'll do the etherpad update, and ping you later for review
16:22:56 <elmiko> edleafe: that would be best, i'm under a deadline for conference stuff =(
16:23:11 <edleafe> elmiko: understood. No worries
16:23:31 <edleafe> So with that, we've covered the agenda. Anyone have anything else to discuss?
16:23:52 <elmiko> nothing here
16:24:32 <edleafe> OK, thanks everyone!
16:24:33 <edleafe> #endmeeting