16:00:22 <edleafe> #startmeeting api sig
16:00:22 <openstack> Meeting started Thu Jan 18 16:00:22 2018 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 <edleafe> #chair cdent elmiko edleafe dtantsur
16:00:23 <openstack> Useful Commands: #action #agreed #help #info #idea #link #topic #startvote.
16:00:23 <edleafe> #link https://wiki.openstack.org/wiki/Meetings/API-SIG#Agenda
16:00:26 <openstack> The meeting name has been set to 'api_sig'
16:00:27 <openstack> Warning: Nick not in channel: cdent
16:00:28 <openstack> Warning: Nick not in channel: elmiko
16:00:29 <openstack> Current chairs: cdent dtantsur edleafe elmiko
16:00:29 <dtantsur> o/
16:00:41 <dtantsur> a small cozy party :)
16:00:44 <edleafe> This should be quick without cdent and elmiko :)
16:01:54 <edleafe> #topic previous meeting action items
16:01:55 <edleafe> #link http://eavesdrop.openstack.org/meetings/api_sig/2018/api_sig.2018-01-11-15.59.html
16:02:06 <edleafe> There was just one for elmiko
16:02:16 <edleafe> elmiko add thoughts to health check review about becoming an api-sig guideline
16:02:36 <dtantsur> he did, and the response is "rather no"
16:02:44 <dtantsur> #link https://review.openstack.org/#/c/531456/ (comments)
16:03:19 * edleafe was just about to paste that link - dtantsur is too fast!
16:03:43 <edleafe> #topic open mic and ongoing or new biz
16:03:49 <edleafe> Nothing on the agenda
16:03:58 <edleafe> Got anything on your mind, dtantsur?
16:04:21 <dtantsur> edleafe: we can argue about https://review.openstack.org/#/c/532814/ :)
16:04:39 <edleafe> sounds like fun!
16:05:10 <edleafe> How about just saying "we don't recommend writing low-level SDKs"?
16:05:39 <dtantsur> edleafe: cool, but not overly helpful
16:05:46 <dtantsur> we have a lot of them, realistically
16:05:55 <dtantsur> and they're not going away, not in the near future at least
16:06:21 <dtantsur> I mean, we can say that, but I'd prefer not to drop recommendations related to them
16:06:29 <edleafe> Yeah, I would argue that they aren't SDKs - they are CLI wrappers, and exist for CLI work
16:06:52 <edleafe> They shouldn't be used programmatically, as an SDK would normally be
16:07:01 <dtantsur> well, they're used as SDKs.. nova uses ironicclient, tripleo uses ***client
16:07:29 <dtantsur> changing this will be a large challenge. we can start with writing a paragraph in this guideline on why we would want people to move to "high-level" SDKs
16:07:31 <edleafe> ...and we should say that's a Bad Thing
16:08:00 <dtantsur> no objections :) I'm only concerned with not providing guidance for low-level "SDKs" that exist today
16:08:11 <dtantsur> because we need it right now for ironicclient and consuming it in Nova
16:08:27 <edleafe> How about we just change the wording:
16:08:51 <edleafe> High-level SDK -> SDK. Low-level SDK -> CLI wrapper
16:09:25 <edleafe> We don't want people to develop their software with CLI wrappers
16:10:07 <edleafe> Anyway, we can have more fun with this when the rest of the gang is here
16:10:19 <edleafe> #topic guidelines
16:10:19 <edleafe> #link https://review.openstack.org/#/q/status:open+project:openstack/api-wg,n,z
16:10:20 <edleafe> #link https://review.openstack.org/#/q/status:open+project:openstack/api-sig,n,z
16:10:46 <dtantsur> edleafe: I don't think we'll get any buy-in for calling things "CLI wrappers"
16:11:17 <edleafe> There was one frozen guideline last week:
16:11:20 <edleafe> #link https://review.openstack.org/#/c/531914/
16:11:21 <dtantsur> anyway, I'll add a note and we'll see where we can get from it
16:11:28 <edleafe> There have been no objections
16:11:32 <dtantsur> merge it? or wait for the folks?
16:11:42 <edleafe> Nah, why wait?
16:11:55 <edleafe> It's pretty tiny
16:12:05 <edleafe> Done
16:12:33 <edleafe> I went through the others this morning
16:13:02 <edleafe> Most are close, but need a bit of fixing/clarification
16:13:20 <edleafe> I just hate to see all the stuff mordred did just sit there
16:13:25 <dtantsur> yep
16:13:47 <edleafe> I'd take them over if a) I had time and b) I knew that stuff like he does
16:13:56 <dtantsur> ENOTIME is a common error code
16:14:23 <edleafe> No, it's the normal state. EHAVETIME is the error
16:14:25 <edleafe> :)
16:14:49 <edleafe> #topic bug review
16:14:51 <edleafe> #link https://bugs.launchpad.net/openstack-api-wg
16:14:57 <edleafe> No new bugs
16:15:22 <edleafe> So that brings us to...
16:15:22 <edleafe> #topic weekly newsletter
16:15:23 <edleafe> #link https://etherpad.openstack.org/p/api-sig-newsletter
16:15:35 <edleafe> I can do that this week
16:15:49 <edleafe> I'll ping you in -sdks when it's ready
16:16:06 <dtantsur> cool!
16:16:16 <dtantsur> this time I may even be present :)
16:16:25 <edleafe> Anything else before I shut this thing down?
16:17:11 <edleafe> ok, then, back to work!
16:17:13 <edleafe> #endmeeting