| Posted | Nick | Remark | |
|---|---|---|---|
| #openstack-sdks - 2019-08-29 | |||
| 16:05:56 | dtantsur | the only reason we haven't done it already is that nobody has time for it | |
| 16:05:58 | elmiko | with the goal being to clean up things that we won't get to, or have shifted scope significantly | |
| 16:06:03 | elmiko | ack | |
| 16:06:12 | elmiko | i'm gonna take an action to make some progress there | |
| 16:06:14 | dtantsur | I'm open to an hour of a call to try tackle it | |
| 16:06:29 | dtantsur | I think a general "let's do it" won't help :) | |
| 16:06:32 | elmiko | how about this, i will start by going through the open reviews and adding my thoughts about them to each | |
| 16:07:00 | elmiko | maybe next week during the hour we can go through and just make some decisions about keeping them open, closing, or w/e | |
| 16:07:07 | dtantsur | ++ | |
| 16:07:16 | elmiko | ok, cool | |
| 16:07:35 | elmiko | gtema_: i am happy to include you in any of this if you would like? | |
| 16:07:43 | gtema_ | sure | |
| 16:07:45 | dtantsur | of course he would :) | |
| 16:08:01 | edleafe | They aren't so much "ToDos" as they are "We know there's a gap here" | |
| 16:08:03 | gtema_ | hehe, dtantsur - you own me a review | |
| 16:08:07 | elmiko | edleafe: ++ | |
| 16:08:11 | dtantsur | really? you owe me a beer! | |
| 16:08:15 | elmiko | i'm not sure what to do about the todos | |
| 16:08:18 | gtema_ | really? | |
| 16:08:25 | dtantsur | (I'm in DUS starting next week, so do your math!) | |
| 16:08:56 | gtema_ | I am not in DUS, was there already 2 times last week and not willing to go again - too crowded | |
| 16:09:00 | elmiko | i wonder if we could replace the todos with some specific language about there not being any guidance yet? is that any better than just a "todo" | |
| 16:09:09 | gtema_ | but I am on DOST in Sept in Berlin. Are you there? | |
| 16:09:29 | dtantsur | gtema_: in in Dusseldorf the whole September probably | |
| 16:09:42 | gtema_ | beh | |
| 16:09:42 | dtantsur | anybody going to OpenInfra Nordics? | |
| 16:09:55 | gtema_ | beh was not to Nordics | |
| 16:10:16 | dtantsur | I may end up here mid-September, depending on various circumstances | |
| 16:10:20 | gtema_ | I'm not - only "Deutsche OpenStack Tage" | |
| 16:10:33 | dtantsur | but my primary goal is to find a flat in DUS asap | |
| 16:10:52 | elmiko | ooh, nice dtantsur ! | |
| 16:10:56 | gtema_ | coool | |
| 16:11:57 | dtantsur | elmiko: I suggest we file a bug per each TODO and then follow the same process | |
| 16:12:05 | dtantsur | fix it OR close and remove the todo | |
| 16:12:28 | elmiko | i feel like that is where we are stuck though, the "fix it or forget it" stage | |
| 16:12:48 | elmiko | but, i like the idea of making some bugs to track this better | |
| 16:12:58 | elmiko | well, maybe not better, but just not in the docs themselves | |
| 16:13:20 | dtantsur | yeah | |
| 16:13:49 | gtema_ | ++ | |
| 16:14:52 | elmiko | so, it's a long holiday weekend here in the states, but i will make some actions next week when i return | |
| 16:15:03 | gtema_ | Guys, what do you think about API header “Accept: “? It does not make any sense from my POV and due to some patch/API Gateways in front some of the requests to Swift in my cloud are failing. | |
| 16:15:20 | efried | merge enormous doc patches, even though they're known to be incomplete, as long as they're at least largely technically accurate. open bugs for known gaps therein. | |
| 16:15:54 | dtantsur | gtema_: in what context? in some contexts it does make sense | |
| 16:16:04 | dtantsur | efried: ++ that's what we're discussing | |
| 16:16:07 | gtema_ | i.e. HEAD request | |
| 16:16:09 | elmiko | efried: my concern here is removing the "TODO" language from the docs and migrating that into bugs | |
| 16:16:48 | efried | I like the idea of keeping TODOs in docs, because they're more likely to be noticed by people consuming the docs, and more noticed is more likely to be acted upon. | |
| 16:16:48 | gtema_ | currently in SDK we enforce "Accept: " for head requests and for create object | |
| 16:16:51 | elmiko | efried: ahh, i see though, you are saying we should push through some of these long standing doc patchs? | |
| 16:17:00 | efried | yes elmiko, this ^ | |
| 16:17:14 | efried | They're stagnant because they're so huge that nobody wants to review them. | |
| 16:17:18 | elmiko | my only problem with that notion is that they have been there for a long time and no one has acted on them | |
| 16:17:24 | dtantsur | I'm not convinced anybody will ever fix TODOs that we don't fix | |
| 16:17:27 | elmiko | the todos that is | |
| 16:17:32 | elmiko | dtantsur: ++ | |
| 16:17:40 | efried | that doesn't mean we should get rid of them | |
| 16:17:47 | efried | that would be like denying that the gaps exist. | |
| 16:17:52 | dtantsur | gtema_: sending Accept without expecting a body is certainly weird | |
| 16:18:02 | efried | If nobody cares about the gaps, then indeed nobody will close them. But that doesn't mean they don't exist. | |
| 16:18:05 | elmiko | i would prefer changing the language from "TODO" to something more reflective of our actual position though. | |
| 16:18:30 | dtantsur | yeah, maybe we should change the syntax to something more user-friendly and saying "The API SIG doesn't currently have a guidance on ..." | |
| 16:18:34 | elmiko | right | |
| 16:18:54 | elmiko | at least let folks know that we have been unable to agree on, or generate guidance for those todos | |
| 16:19:03 | dtantsur | a raw TODO in text may give an impression that we're working on it | |
| 16:19:06 | dtantsur | while we're not working :) | |
| 16:19:09 | elmiko | "todo" sounds like we might actually get around to it | |
| 16:19:15 | elmiko | dtantsur: yes! | |
| 16:19:21 | dtantsur | elmiko: are you reading my thoughts??? | |
| 16:19:25 | elmiko | hahaha | |
| 16:19:28 | gtema_ | dtantsur: that's what we do. But it is something more general, that from the API pov there are no real guidance | |
| 16:19:36 | efried | .. help-wanted:: | |
| 16:19:36 | efried | Consider a new | |
| 16:19:36 | efried | role | |
| 16:19:47 | elmiko | that's a nice thought efried | |
| 16:19:49 | dtantsur | that would be ideal | |
| 16:19:59 | efried | stephenfin could work that up for us in all his spare time. | |
| 16:20:05 | edleafe | elmiko: "todo" sounds like there is a plan to actually get around to it :) | |
| 16:20:16 | gtema_ | agree | |
| 16:20:18 | elmiko | edleafe: exactly, i want to be more transparent | |
| 16:20:34 | elmiko | efried: i would be happy with a "help wanted" plus changing the todo language to something more honest | |
| 16:21:05 | elmiko | well, more reflective of our actual intentions | |
| 16:21:23 | dtantsur | and maybe some rough ideas on what a guidelines could look like | |
| 16:21:29 | efried | I didn't want to get into this on the ML, but I don't like the idea that "if nobody is asking it must not be important". | |
| 16:21:31 | stephenfin | efried: | |
| 16:21:33 | stephenfin | .. admonition:: Help wanted | |
| 16:21:34 | stephenfin | ||
| 16:21:34 | dtantsur | "We don't know for sure, but something in spirit of RFC XYZ" | |
| 16:21:38 | dtantsur | yeah | |
| 16:21:38 | stephenfin | Stuff. | |
| 16:21:46 | stephenfin | QED | |
| 16:21:54 | elmiko | efried: ++, that's a good thought to capture | |
| 16:21:57 | efried | stephenfin: cool, I had a feeling there might be something existing that would work. | |
| 16:22:10 | elmiko | they _are_ important, but we have failed as a sig to arrive at any guidance on those topics | |
| 16:22:12 | dtantsur | tripleo-docs uses admonitions quite actively, we can check how they do it | |
| 16:22:23 | elmiko | dtantsur: ++ | |
| 16:22:24 | efried | All too often people just give up because it's too hard or time consuming or soul-sucking to continue complaining about stuff that's been TODO f'rever. | |
| 16:22:51 | dtantsur | if we had one person per each big project.. cough-cough | |
| 16:23:10 | dtantsur | :D | |
| 16:23:16 | elmiko | haha | |
| 16:23:20 | efried | It's just that we're all stretched so thin | |