| *** yamamoto has quit IRC | 00:01 | |
| *** yamamoto has joined #openstack-doc | 00:01 | |
| *** masaki has joined #openstack-doc | 00:02 | |
| *** charcol has quit IRC | 00:29 | |
| *** thorst has joined #openstack-doc | 00:38 | |
| *** charcol has joined #openstack-doc | 00:39 | |
| *** thorst has quit IRC | 00:43 | |
| *** yamamoto has quit IRC | 00:52 | |
| *** yamamoto has joined #openstack-doc | 00:55 | |
| *** yangyapeng has joined #openstack-doc | 00:59 | |
| *** yamamoto has quit IRC | 01:26 | |
| *** thorst has joined #openstack-doc | 01:39 | |
| *** edmondsw has joined #openstack-doc | 01:40 | |
| *** thorst has quit IRC | 01:43 | |
| *** edmondsw has quit IRC | 01:45 | |
| *** yamamoto has joined #openstack-doc | 01:48 | |
| *** annegentle has joined #openstack-doc | 01:52 | |
| *** edmondsw has joined #openstack-doc | 01:54 | |
| *** yamamoto has quit IRC | 01:58 | |
| *** yamamoto has joined #openstack-doc | 01:59 | |
| *** edmondsw has quit IRC | 02:01 | |
| *** gouthamr has quit IRC | 02:07 | |
| *** yamamoto has quit IRC | 02:10 | |
| *** annegentle has quit IRC | 02:12 | |
| *** yamamoto has joined #openstack-doc | 02:13 | |
| *** thorst has joined #openstack-doc | 02:40 | |
| *** thorst has quit IRC | 02:44 | |
| *** skelso has joined #openstack-doc | 03:10 | |
| *** skelso has quit IRC | 03:23 | |
| *** edmondsw has joined #openstack-doc | 03:30 | |
| *** edmondsw has quit IRC | 03:35 | |
| *** thorst has joined #openstack-doc | 04:41 | |
| *** thorst has quit IRC | 04:46 | |
| *** Dinesh_Bhor has joined #openstack-doc | 04:49 | |
| *** hyakuhei has quit IRC | 05:12 | |
| *** edmondsw has joined #openstack-doc | 05:18 | |
| *** edmondsw has quit IRC | 05:23 | |
| openstackgerrit | Andreas Jaeger proposed openstack/openstack-manuals master: [www] Add heat-translator https://review.openstack.org/493429 | 05:27 |
|---|---|---|
| openstackgerrit | Andreas Jaeger proposed openstack/openstack-manuals master: [www] Add heat-translator https://review.openstack.org/493429 | 05:29 |
| openstackgerrit | Andreas Jaeger proposed openstack/openstack-manuals master: [www] Add heat-translator https://review.openstack.org/493429 | 05:37 |
| *** thorst has joined #openstack-doc | 05:42 | |
| *** thorst has quit IRC | 05:47 | |
| *** yamamoto has quit IRC | 06:21 | |
| *** phuongnh has joined #openstack-doc | 06:30 | |
| *** charcol has quit IRC | 06:38 | |
| *** thorst has joined #openstack-doc | 06:43 | |
| *** suyog has quit IRC | 06:45 | |
| *** thorst has quit IRC | 06:48 | |
| *** rcernin has joined #openstack-doc | 06:56 | |
| *** edmondsw has joined #openstack-doc | 07:07 | |
| *** tesseract has joined #openstack-doc | 07:10 | |
| *** edmondsw has quit IRC | 07:11 | |
| *** jpena|off is now known as jpena | 07:22 | |
| *** AJaeger has quit IRC | 07:41 | |
| *** thorst has joined #openstack-doc | 07:44 | |
| *** thorst has quit IRC | 07:49 | |
| *** AJaeger has joined #openstack-doc | 07:49 | |
| *** yamamoto has joined #openstack-doc | 07:54 | |
| *** yamamoto has quit IRC | 08:12 | |
| *** yamamoto has joined #openstack-doc | 08:14 | |
| *** yamamoto has quit IRC | 08:23 | |
| *** tosky has joined #openstack-doc | 08:37 | |
| *** yamamoto has joined #openstack-doc | 08:43 | |
| *** openstackgerrit has quit IRC | 08:48 | |
| *** edmondsw has joined #openstack-doc | 08:55 | |
| *** edmondsw has quit IRC | 08:59 | |
| *** masaki has quit IRC | 09:02 | |
| *** sambetts|afk is now known as sambetts | 09:10 | |
| *** openstackgerrit has joined #openstack-doc | 09:44 | |
| openstackgerrit | Merged openstack/openstack-manuals master: open queens doc development https://review.openstack.org/493234 | 09:44 |
| *** thorst has joined #openstack-doc | 09:45 | |
| *** thorst has quit IRC | 09:50 | |
| *** efoley has joined #openstack-doc | 09:58 | |
| *** efoley_ has joined #openstack-doc | 09:59 | |
| *** efoley has quit IRC | 10:02 | |
| *** yangyapeng has quit IRC | 10:06 | |
| asettle | dhellmann and AJaeger https://docs.openstack.org/mitaka/admin/ | 10:19 |
| asettle | When navigating to 'mitaka' you receive 'pike' | 10:19 |
| *** efoley__ has joined #openstack-doc | 10:27 | |
| *** efoley_ has quit IRC | 10:27 | |
| *** phuongnh has quit IRC | 10:28 | |
| *** efoley_ has joined #openstack-doc | 10:28 | |
| *** efoley__ has quit IRC | 10:28 | |
| *** efoley_ has quit IRC | 10:31 | |
| *** efoley_ has joined #openstack-doc | 10:31 | |
| *** yamamoto has quit IRC | 10:37 | |
| *** yamamoto has joined #openstack-doc | 10:40 | |
| *** yamamoto has quit IRC | 10:40 | |
| *** edmondsw has joined #openstack-doc | 10:43 | |
| *** thorst has joined #openstack-doc | 10:46 | |
| AJaeger | asettle: that's correct! REad the information above the link - the text box explains the reason | 10:46 |
| asettle | AJaeger: i'm a knob LOL. I read the first sentence and was like 'this explains nothing!' | 10:47 |
| asettle | Maybe Ill just update that so it's more obvious... | 10:47 |
| *** edmondsw has quit IRC | 10:47 | |
| AJaeger | asettle: please do update so that everybody understands it... | 10:48 |
| asettle | AJaeger: I'm having the time of my life doing hte contrib guide | 10:48 |
| asettle | I'll do after :p0 | 10:49 |
| asettle | :) * | 10:49 |
| AJaeger | oh, fun... | 10:49 |
| asettle | Tell me about it | 10:49 |
| *** thorst has quit IRC | 10:51 | |
| *** ykarel has joined #openstack-doc | 10:54 | |
| ykarel | Hi | 10:55 |
| ykarel | can anyone help in debugging, warning-is-error | 10:55 |
| ykarel | Actually warning-is-error=1 in [build_sphinx], still it's not reported as error:- | 10:56 |
| ykarel | https://github.com/openstack/sahara/blob/master/setup.cfg#L85 | 10:56 |
| AJaeger | ykarel: do you have a change up? | 10:56 |
| ykarel | http://logs.openstack.org/97/491297/2/gate/gate-sahara-docs-ubuntu-xenial/32514e2/console.html#_2017-08-10_19_38_31_317933 | 10:56 |
| ykarel | I know the reason of warning but don't know why it's not reported as error: 'help' is missing for config param 'publisher_id': https://github.com/openstack/sahara/blob/master/sahara/utils/notification/sender.py#L36 | 10:57 |
| ykarel | AJaeger, no i haven't pushed any patch, i am providing reference from existing code, logs ^^ | 10:58 |
| AJaeger | ykarel: let me check locally... | 10:58 |
| ykarel | AJaeger, Ok | 10:58 |
| *** yamamoto has joined #openstack-doc | 10:59 | |
| AJaeger | ykarel: I don't see any warning produced in the log file | 10:59 |
| ykarel | AJaeger, have you seen: http://logs.openstack.org/97/491297/2/gate/gate-sahara-docs-ubuntu-xenial/32514e2/console.html#_2017-08-10_19_38_31_317933 | 11:00 |
| ykarel | build succeeded, 1 warning. | 11:00 |
| *** yamamoto has quit IRC | 11:04 | |
| AJaeger | ykarel: exactly - but where is the warning itself? | 11:04 |
| ykarel | AJaeger, yes that's not shown, and i don't know why | 11:06 |
| ykarel | AJaeger, that's why i asked how can i debug this | 11:07 |
| ykarel | if i add help here: https://github.com/openstack/sahara/blob/master/sahara/utils/notification/sender.py#L36, i just see: "build succeeded", but i wan't to know why warning-is-error is not working | 11:08 |
| AJaeger | I just add a missing toc entry and now get " | 11:08 |
| AJaeger | "Warning, treated as error:" | 11:09 |
| AJaeger | So, everything is working as it should on that side. | 11:09 |
| AJaeger | I don't know why the message appears as is - but everything looks fine otherwise. warning-is-error is working for me | 11:09 |
| ykarel | AJaeger, but it's not working for oslo_config i think, missing help for 'publisher_id' | 11:11 |
| ykarel | AJaeger, do you know how can i start debugging this | 11:13 |
| AJaeger | ykarel: I do not get such a warning for oslo_config in my local copy | 11:17 |
| AJaeger | ykarel: sorry, can't help further here. | 11:18 |
| ykarel | AJaeger, really, strange | 11:18 |
| ykarel | AJaeger, thanks, | 11:18 |
| openstackgerrit | Alexandra Settle proposed openstack/openstack-manuals master: [contrib-guide] Top level edits for new doc team structure https://review.openstack.org/493513 | 11:19 |
| *** yamamoto has joined #openstack-doc | 11:30 | |
| *** yangyapeng has joined #openstack-doc | 11:31 | |
| *** pkovar has joined #openstack-doc | 11:32 | |
| *** jpena is now known as jpena|lunch | 11:38 | |
| *** yangyapeng has quit IRC | 11:43 | |
| openstackgerrit | Alexandra Settle proposed openstack/openstack-manuals master: [contrib-guide] Top level edits for new doc team structure https://review.openstack.org/493513 | 11:45 |
| *** nicolasbock has joined #openstack-doc | 11:57 | |
| *** thorst has joined #openstack-doc | 12:14 | |
| asettle | oh that's nice | 12:18 |
| asettle | AJaeger dhellmann - open up docs.o.o | 12:18 |
| asettle | Click on the 'search' | 12:18 |
| asettle | Does yours disappear, or is my browser being a dickhead? | 12:18 |
| asettle | Shit. I just got others to test. Okay. So, it appears to happen for the pike/ocata/newton/mitaka pages... shite | 12:22 |
| *** jpena|lunch is now known as jpena | 12:25 | |
| *** krtaylor has quit IRC | 12:37 | |
| *** krtaylor has joined #openstack-doc | 12:42 | |
| *** rbowen has joined #openstack-doc | 12:43 | |
| pkovar | asettle: isn't that a feature? it refocuses to the search input box below... | 12:48 |
| *** edmondsw has joined #openstack-doc | 12:49 | |
| asettle | I would call it a feature if the whole thing didn't disappear | 12:49 |
| asettle | I'm fairly certain the 'software, users, community, etc' are not supposed to disappear too | 12:49 |
| asettle | If it is said feature, we might want to improve on that one ;) | 12:49 |
| pkovar | good point | 12:49 |
| asettle | I've had a poke around, and I'm genuinely not too sure how to fix htat one | 12:52 |
| asettle | I'll ask Anne when she gets in | 12:52 |
| *** nicolasbock has quit IRC | 13:03 | |
| *** eumel8 has joined #openstack-doc | 13:17 | |
| *** yangyapeng has joined #openstack-doc | 13:23 | |
| *** yangyapeng has quit IRC | 13:26 | |
| *** yangyapeng has joined #openstack-doc | 13:26 | |
| openstackgerrit | Alexandra Settle proposed openstack/openstack-manuals master: [contrib-guide] Top level edits for new doc team structure https://review.openstack.org/493513 | 13:52 |
| *** gouthamr has joined #openstack-doc | 14:02 | |
| *** chlong has joined #openstack-doc | 14:04 | |
| *** phil_h has joined #openstack-doc | 14:05 | |
| *** annegentle has joined #openstack-doc | 14:11 | |
| *** KeithMnemonic has joined #openstack-doc | 14:15 | |
| *** yangyapeng has quit IRC | 14:20 | |
| *** catintheroof has joined #openstack-doc | 14:21 | |
| *** yangyapeng has joined #openstack-doc | 14:22 | |
| *** donghao has joined #openstack-doc | 14:38 | |
| *** annegentle has quit IRC | 14:57 | |
| *** rcernin has quit IRC | 15:00 | |
| *** lucasxu has joined #openstack-doc | 15:05 | |
| *** amotoki is now known as amotoki__away | 15:14 | |
| *** lucasxu has quit IRC | 15:38 | |
| pkovar | what are everybody's thoughts on specifying redirects without the trailing slash? | 15:39 |
| pkovar | e.g. redirect 301 /latest /pike instead of redirect 301 /latest/ /pike/ | 15:40 |
| pkovar | should cover links to both /pike/ and /pike | 15:40 |
| pkovar | if I'm not mistaken | 15:40 |
| pkovar | s/pike/latest/ but you got the idea :) | 15:41 |
| asettle | pkovar: no strong feelings? | 15:44 |
| asettle | Guess it's just one of those things that you do cause you do? | 15:44 |
| *** chlong has quit IRC | 15:45 | |
| *** chlong_ has joined #openstack-doc | 15:45 | |
| openstackgerrit | Alexandra Settle proposed openstack/openstack-manuals master: [contrib-guide] Top level edits for new doc team structure https://review.openstack.org/493513 | 15:45 |
| ykarel | AJaeger, regarding warning-is-error, To me it looks there is some issue in how sphinx handles log warnings and how oslo_config is emitting log warnings | 15:47 |
| ykarel | looking at sphinx code: https://github.com/sphinx-doc/sphinx/blob/master/sphinx/util/logging.py#L327-L329 | 15:47 |
| ykarel | oslo_config code for generating conf file, where warning is emitted: https://github.com/openstack/oslo.config/blob/master/oslo_config/generator.py#L225-L226 | 15:49 |
| ykarel | https://github.com/openstack/oslo.config/blob/master/oslo_config/generator.py#L28 | 15:49 |
| ykarel | sphinx require type and subtype for treating them warning-is-error, but logging module doesn't have that | 15:50 |
| pkovar | asettle: it's more about saving extra lines in the config. right now, we specify the slashes and https://docs.openstack.org/latest doesn't work, for example | 15:51 |
| ykarel | thus in this case, type and subtype would always be None, and WarningSuppressor will return False | 15:51 |
| ykarel | sorry True | 15:51 |
| tosky | and talking about strange warnings, I was rechecking the bug opened by ykarel earlier: https://bugs.launchpad.net/sahara/+bug/1710608 | 15:52 |
| openstack | Launchpad bug 1710608 in Sahara ""python setup.py build_sphinx -b man" not working" [Undecided,New] | 15:52 |
| tosky | and I' | 15:52 |
| asettle | pkovar: I think that's because we moved from latest. https://docs.openstack.org/pike works | 15:52 |
| tosky | I'm puzzled, it's only for manpages, and no references around apart from the sphinx source code | 15:52 |
| ykarel | tosky, yes that's a seperate issue | 15:52 |
| pkovar | asettle: try https://docs.openstack.org/latest/ ;) | 15:52 |
| pkovar | we have redirect 301 /latest/ /pike/ set up | 15:53 |
| asettle | pkovar: yeah, so, the redirect for /latest doesn't work. Which we can fix - we clearly just haven't setup /latest to redirect. I mean, I have no argument with you - valid point completely. | 15:53 |
| asettle | If you wanna go ahead and update that, I genuinely have no qualms. It makes sense. More space. | 15:53 |
| asettle | I'm just saying the other one redirects, which is probably why nobody has bothered to care :p | 15:54 |
| ykarel | tosky, do you need some other info in bug: https://bugs.launchpad.net/sahara/+bug/1710608 | 15:55 |
| openstack | Launchpad bug 1710608 in Sahara ""python setup.py build_sphinx -b man" not working" [Undecided,New] | 15:55 |
| pkovar | asettle: actually, i'm not a redirect guru and don't want to break things too much, but let me create a change so people can comment | 15:55 |
| tosky | ykarel: given that the table works with the HTML writer, I think it's a limitation in the man page writer | 15:56 |
| tosky | ykarel: on the other side, where do we enable it? | 15:56 |
| asettle | pkovar: haha neither am I. I just blob around and hope it works :P | 15:56 |
| asettle | But sounds like a good idea :) | 15:56 |
| tosky | ykarel: I mean, do we generate the man pages for the user documentation? | 15:56 |
| pkovar | heh | 15:56 |
| ykarel | tosky, we build man pages in RDO | 15:56 |
| tosky | ykarel: also for non commands? | 15:57 |
| tosky | ok, discussion for #rdo | 15:57 |
| ykarel | tosky, https://github.com/rdo-packages/sahara-distgit/blob/rpm-master/openstack-sahara.spec#L311 | 15:57 |
| ykarel | that i am not sure why we are generating man for non-commands, but i can check | 15:58 |
| tosky | I just asked | 15:58 |
| ykarel | Ok, moving there | 15:58 |
| tosky | ykarel: I still have to test your change, did you see if it produces the same output? | 15:59 |
| ykarel | tosky, i haven't seen the output, but it didn't reported the warning | 16:00 |
| tosky | ykarel: which does not mean that it produces a proper table both for man and html :) | 16:01 |
| *** tesseract has quit IRC | 16:01 | |
| ykarel | tosky, yes | 16:01 |
| *** jpena is now known as jpena|off | 16:05 | |
| *** jpena|off is now known as jpena | 16:08 | |
| *** rbowen has quit IRC | 16:14 | |
| *** rbowen has joined #openstack-doc | 16:17 | |
| *** lucasxu has joined #openstack-doc | 16:19 | |
| *** yamamoto has quit IRC | 16:21 | |
| *** donghao has quit IRC | 16:36 | |
| *** ykarel has quit IRC | 16:37 | |
| *** jpena is now known as jpena|off | 16:50 | |
| *** rcernin has joined #openstack-doc | 16:58 | |
| *** yamamoto has joined #openstack-doc | 17:22 | |
| *** sambetts is now known as sambetts|afk | 17:25 | |
| *** bsilverman_ has joined #openstack-doc | 17:29 | |
| *** yamamoto has quit IRC | 17:29 | |
| *** annegentle has joined #openstack-doc | 17:30 | |
| *** tosky has quit IRC | 17:34 | |
| annegentle | asettle read scrollback, and that has always been the search behavior. | 17:35 |
| annegentle | AJaeger figure it's getting late for you, but if you could look at https://review.openstack.org/#/c/493107/ would appreciate | 17:37 |
| annegentle | asettle I mean, _I_ read the scrollback :) | 17:38 |
| *** ykarel has joined #openstack-doc | 17:38 | |
| AJaeger | annegentle: looking at http://docs-draft.openstack.org/07/493107/3/check/gate-openstackdocstheme-docs-ubuntu-xenial/b573ab4//doc/build/html/ - is that the search button at the top? | 17:40 |
| AJaeger | annegentle: found it at http://docs-draft.openstack.org/07/493107/3/check/gate-openstackdocstheme-docs-ubuntu-xenial/b573ab4//doc/build/html/demo/index.html | 17:40 |
| *** pkovar has quit IRC | 17:41 | |
| AJaeger | ok, looks fine... | 17:41 |
| annegentle | AJaeger ah, so could be difference between jinja template and openstackdocstheme | 17:41 |
| annegentle | AJaeger right? Because the /ocata landing is jinja2 iirc | 17:41 |
| AJaeger | annegentle: it's the link to search page which is normal on index.rst but not in our demo page. So, all fine. I +3 | 17:42 |
| annegentle | AJaeger ok, thanks! | 17:43 |
| annegentle | AJaeger dhellmann okay if I send through an openstackdocstheme release request? | 17:43 |
| AJaeger | annegentle: sure - but note this will be for queens - pike is done deal, no more updates for requirements file for pike... | 17:44 |
| annegentle | AJaeger yup, I figured | 17:44 |
| AJaeger | annegentle: could you +3 https://review.openstack.org/492983 as well? Just a cleanup | 17:44 |
| openstackgerrit | Merged openstack/openstackdocstheme master: Bring back local search https://review.openstack.org/493107 | 17:48 |
| annegentle | AJaeger ayup | 17:48 |
| *** emagana has joined #openstack-doc | 17:51 | |
| openstackgerrit | Merged openstack/openstackdocstheme master: Cleanup setup.cfg https://review.openstack.org/492983 | 17:53 |
| *** ykarel has quit IRC | 18:02 | |
| *** lucasxu has quit IRC | 18:07 | |
| *** annegentle has quit IRC | 18:17 | |
| *** lucasxu has joined #openstack-doc | 18:18 | |
| *** d0ugal has quit IRC | 18:19 | |
| *** annegentle has joined #openstack-doc | 18:39 | |
| *** Monique_ has joined #openstack-doc | 18:52 | |
| *** Monique_ has left #openstack-doc | 18:54 | |
| *** MoniqueDawson has joined #openstack-doc | 19:19 | |
| MoniqueDawson | annegentle | 19:19 |
| MoniqueDawson | Hi Anne, you around? | 19:19 |
| annegentle | hey MoniqueDawson | 19:19 |
| MoniqueDawson | Nice to meet you. | 19:19 |
| annegentle | MoniqueDawson yep - saw you pop on and off so I figured you were getting there :) | 19:19 |
| MoniqueDawson | Yep | 19:19 |
| annegentle | MoniqueDawson Nice to meet you too! | 19:19 |
| MoniqueDawson | So, while it doesn't seem like it, I've been busy getting started. | 19:20 |
| annegentle | MoniqueDawson good on ya! | 19:20 |
| MoniqueDawson | I am still working on Linux. I am going to try to install it on an external hard drive and boot from Windows. | 19:21 |
| annegentle | nice | 19:21 |
| MoniqueDawson | I've connected with someone from a Linux user group and we are going to meet next weekend to get it installed. | 19:21 |
| MoniqueDawson | Does the group use git and github? | 19:21 |
| annegentle | MoniqueDawson Yes, Git, and Gerrit is our review system at review.openstack.org, so the workflow does not involve GitHub directly, but our repos are mirrored to GitHub. Does that help? | 19:23 |
| MoniqueDawson | Yes, I think I follow. | 19:24 |
| MoniqueDawson | What advice do you have for someone starting out? | 19:25 |
| annegentle | MoniqueDawson figure out your goals - is it to learn Git? Cloud? | 19:26 |
| annegentle | MoniqueDawson I'm a fan of real practice to figure that out also. | 19:27 |
| annegentle | MoniqueDawson it's just hard to try to direct anyone starting out if I don't know what they'd want out of it. If it's a bug fix, that's great. If it's a new job, that's another goal with new tactics :) | 19:27 |
| MoniqueDawson | annegentle initially my goals were to gain exposure and experience to working on API doc. | 19:28 |
| annegentle | MoniqueDawson ok, the way we do REST API docs in OpenStack is by using Sphinx with RST docs and some specialized Sphinx extensions, to output this type of doc: https://developer.openstack.org/api-ref/compute/ | 19:30 |
| MoniqueDawson | annegentle but now I'm learning there are sets of development tools that I need to learn, like Linux distributions, git, even IRC is new to me. | 19:30 |
| annegentle | MoniqueDawson that's for our largest REST API, Compute, with probably 900 calls | 19:30 |
| annegentle | MoniqueDawson the Linux part is so that your dev environment best matches the build environment and so you can build locally. | 19:30 |
| annegentle | MoniqueDawson the Git part can be done with Windows and Git Bash | 19:31 |
| annegentle | MoniqueDawson but yes, Git Bash uses Linux commands. | 19:31 |
| annegentle | MoniqueDawson the separation of knowledge is that the workflow for editing/authoring is very git-centric | 19:31 |
| annegentle | MoniqueDawson and the REST API knowledge is different from the Git Bash / Linux knowledge | 19:31 |
| annegentle | MoniqueDawson does that help? | 19:31 |
| MoniqueDawson | yes | 19:31 |
| annegentle | MoniqueDawson I don't know if you connected the dots, but I wrote a book and site, docslikecode.com that describes this new way of working | 19:31 |
| MoniqueDawson | annegentle cool. I'll take a look | 19:32 |
| MoniqueDawson | annegentle how long have you been documenting APIs? | 19:32 |
| annegentle | MoniqueDawson 2010? | 19:32 |
| MoniqueDawson | annegentle looking at docslikecode.com .... | 19:34 |
| annegentle | MoniqueDawson this article gives a good overall idea of the recent journey we've had in the project related to REST API docs http://superuser.openstack.org/articles/openstack-api-documentation-update/ and http://superuser.openstack.org/articles/what-s-next-for-openstack-application-developer-guides/ | 19:34 |
| annegentle | MoniqueDawson Basically, all REST API docs have moved into each project's repo. | 19:35 |
| annegentle | MoniqueDawson If you're looking for the overall industry movement, it's towards Swagger/OpenAPI. | 19:37 |
| MoniqueDawson | annegentle okay. I'll save off all of URLs and take a look at | 19:37 |
| annegentle | MoniqueDawson so for your end goal, you may want to play around with Open API tutorials, perhaps. | 19:38 |
| MoniqueDawson | annegentle interesting you mention Swagger. I read Tom Johnson's "Documenting APIs: A guide for technical writers" | 19:38 |
| annegentle | MoniqueDawson Yep, what did you think? | 19:39 |
| MoniqueDawson | annegentle and he talks about Swagger and Swagger is also one of his sponsor | 19:39 |
| annegentle | MoniqueDawson right. It's a great standard but did not fit our API design. It's a wide-use-case tool, not just for docs. | 19:39 |
| MoniqueDawson | annegentle about Tom's guide? I think it is excellent! There's a lot to digest. | 19:39 |
| annegentle | MoniqueDawson yep, I know Tom | 19:40 |
| MoniqueDawson | annegentle I've been know to say it's one great big small world! | 19:40 |
| annegentle | MoniqueDawson for certain! | 19:41 |
| MoniqueDawson | annegentle I will definitely save off the URLs you've provided and continue to look at the OpenStack contributor guide | 19:42 |
| annegentle | MoniqueDawson sounds good. | 19:43 |
| MoniqueDawson | annegentle and by next week I should have my Linux environment and then go from there... how does that sound? | 19:43 |
| annegentle | MoniqueDawson sounds like a plan - I tested https://docs.openstack.org/contributor-guide/quickstart/first-timers.html#set-up-git-and-git-review on my Windows computer in Git Bash so hopefully it works | 19:44 |
| annegentle | MoniqueDawson was probably last summer last I tested it :) | 19:45 |
| MoniqueDawson | annegentle yes, I think I was following that doc to set up all my accounts. | 19:46 |
| annegentle | MoniqueDawson on Windows, you won't be able to run tox -e docs without errors, the dependencies are for Linux machines. But that shouldn't deter you | 19:47 |
| MoniqueDawson | annegentle Yes, I think being on Linux will help out a lot. | 19:49 |
| annegentle | MoniqueDawson I like Mac myself but it's really fine since all builds happen in the cloud infra :) | 19:50 |
| MoniqueDawson | annegentle There is a Phoenix OpenStack Meetup group that I've joined. Do you know Ben Silverman? He's one of the organizers. | 19:50 |
| annegentle | MoniqueDawson yep, based on the project he works on and I've chatted with him here in IRC and probably met at one of the Summits | 19:50 |
| MoniqueDawson | annegentle He and I haven't met yet. But he's the one who pointed me to Alex Settle. He also says he's on the OpenStack doc committee | 19:51 |
| MoniqueDawson | annegentle I think I have enough to keep me going. Is there anything else we should chat about now? | 19:52 |
| annegentle | MoniqueDawson everyone writes docs :) Alex leads the team currently and we're having an election as scheduled after our six-month release cycle for a new docs lead. | 19:53 |
| annegentle | MoniqueDawson nope, carry on! | 19:53 |
| MoniqueDawson | annegentle sounds good, Anne. Thanks again for your time! I'll let you and Alex know when I'm up and running on Linux. | 19:53 |
| *** skelso has joined #openstack-doc | 19:54 | |
| MoniqueDawson | annegentle take care! | 19:54 |
| *** phil_h has quit IRC | 19:59 | |
| *** d0ugal has joined #openstack-doc | 20:12 | |
| *** MoniqueDawson has quit IRC | 20:21 | |
| *** sekelso has joined #openstack-doc | 20:34 | |
| *** skelso has quit IRC | 20:35 | |
| *** efoley_ has quit IRC | 20:40 | |
| *** lucasxu has quit IRC | 20:41 | |
| *** eumel8 has quit IRC | 20:42 | |
| *** shaunm has joined #openstack-doc | 20:44 | |
| *** gouthamr has quit IRC | 20:51 | |
| *** thorst has quit IRC | 21:05 | |
| *** yamamoto has joined #openstack-doc | 21:08 | |
| *** yamamoto has quit IRC | 21:20 | |
| *** sekelso has quit IRC | 21:28 | |
| *** sekelso has joined #openstack-doc | 21:28 | |
| *** thorst has joined #openstack-doc | 21:30 | |
| *** thorst has quit IRC | 21:34 | |
| *** thorst has joined #openstack-doc | 21:36 | |
| *** thorst has quit IRC | 21:39 | |
| *** shaunm has quit IRC | 21:39 | |
| *** shaunm has joined #openstack-doc | 21:39 | |
| *** yamamoto has joined #openstack-doc | 21:57 | |
| *** edmondsw has quit IRC | 22:01 | |
| *** edmondsw has joined #openstack-doc | 22:03 | |
| *** edmondsw has quit IRC | 22:03 | |
| *** sekelso has quit IRC | 22:08 | |
| *** katyafervent_awa has quit IRC | 22:12 | |
| *** katyafervent_awa has joined #openstack-doc | 22:15 | |
| *** suyog has joined #openstack-doc | 22:30 | |
| *** thorst has joined #openstack-doc | 22:39 | |
| *** gouthamr has joined #openstack-doc | 22:39 | |
| bsilverman_ | Wait, I never said I was on any Docs committee, I wouldn’t subject myself to such torture! I think I said “I am on the Docs Team.“ :slightly_smiling_face: | 22:40 |
| bsilverman_ | annegentle: We’ve met many times, I’m the very large guy with the beard. We talked a bit at the last PTG, I was in the docs room the whole time with you and Alex. I’m very hard to forget. | 22:42 |
| *** thorst has quit IRC | 22:44 | |
| * bsilverman_ goes back to read-only mode. | 22:45 | |
| *** charcol has joined #openstack-doc | 22:46 | |
| annegentle | bsilverman_ heya :) Sorry about that! | 22:48 |
| annegentle | bsilverman_ I did have a moment "what's the docs committee" LOL | 22:48 |
| annegentle | bsilverman_ ha ha I had you confused with Ben Swartzlander, who I don't know if I've met, but yes, I remember you :) | 22:49 |
| bsilverman_ | annegentle: If I had a dollar for every time someone switched Swartzlander and I. Well, I’d have a lot of dollars. | 22:49 |
| annegentle | bsilverman_ ha! Good to know I'm not the only person relying on initials for mneumonics | 22:50 |
| bsilverman_ | annegentle: Monique came to me via my Meetup group in Phoenix, I gave her an introduction and then sent her to Alex, glad she’s followed up. I’m like 1-4 with on-boarding new members. I get them all setup and then they don’t do anything. | 22:51 |
| *** rcernin has quit IRC | 23:02 | |
| *** catintheroof has quit IRC | 23:12 | |
| *** katyafervent_awa has quit IRC | 23:22 | |
| *** katyafervent_awa has joined #openstack-doc | 23:24 | |
| *** charcol-v2 has joined #openstack-doc | 23:25 | |
| *** charcol has quit IRC | 23:25 | |
| *** charcol-v2 is now known as charcol | 23:26 | |
| *** charcol has quit IRC | 23:32 | |
| *** charcol has joined #openstack-doc | 23:33 | |
| *** gouthamr has quit IRC | 23:51 | |
| *** annegentle has quit IRC | 23:51 | |
| *** krtaylor has quit IRC | 23:51 | |
| *** AJaeger has quit IRC | 23:51 | |
| *** Dinesh_Bhor has quit IRC | 23:51 | |
| *** shaunm has quit IRC | 23:51 | |
| *** bswartz has quit IRC | 23:51 | |
| *** odyssey4me has quit IRC | 23:51 | |
| *** reed has quit IRC | 23:51 | |
| *** cburgess has quit IRC | 23:51 | |
| *** d0ugal has quit IRC | 23:51 | |
| *** larainema has quit IRC | 23:51 | |
| *** asettle has quit IRC | 23:51 | |
| *** dims has quit IRC | 23:51 | |
| *** seongsoocho has quit IRC | 23:51 | |
| *** uberjay has quit IRC | 23:51 | |
| *** andymccr has quit IRC | 23:51 | |
| *** laurelm has quit IRC | 23:51 | |
| *** sgordon has quit IRC | 23:51 | |
| *** EmilienM has quit IRC | 23:51 | |
| *** openstackgerrit has quit IRC | 23:51 | |
| *** chason has quit IRC | 23:51 | |
| *** csatari has quit IRC | 23:51 | |
| *** mrmartin has quit IRC | 23:51 | |
| *** bsilverman_ has quit IRC | 23:51 | |
| *** rbowen has quit IRC | 23:51 | |
| *** oanson has quit IRC | 23:51 | |
| *** mpranjic has quit IRC | 23:51 | |
| *** mfisch` has quit IRC | 23:51 | |
| *** sambetts|afk has quit IRC | 23:51 | |
| *** jeblair has quit IRC | 23:51 | |
| *** tonyb has quit IRC | 23:51 | |
| *** mhayden has quit IRC | 23:51 | |
| *** johnthetubaguy has quit IRC | 23:51 | |
| *** ericyoung has quit IRC | 23:51 | |
| *** bradjones has quit IRC | 23:51 | |
| *** emagana has quit IRC | 23:51 | |
| *** junbo has quit IRC | 23:51 | |
| *** dhellmann has quit IRC | 23:51 | |
| *** notmyname has quit IRC | 23:51 | |
| *** ildikov has quit IRC | 23:51 | |
| *** kencjohnston_ has quit IRC | 23:51 | |
| *** chlong_ has quit IRC | 23:51 | |
| *** yangyapeng has quit IRC | 23:51 | |
| *** med_ has quit IRC | 23:51 | |
| *** alex_xu has quit IRC | 23:51 | |
| *** yamamoto has quit IRC | 23:51 | |
| *** betherly has quit IRC | 23:51 | |
| *** simonmcc has quit IRC | 23:51 | |
| *** timsim has quit IRC | 23:51 | |
| *** berendt has quit IRC | 23:51 | |
| *** TheJulia has quit IRC | 23:51 | |
| *** Qiming has quit IRC | 23:51 | |
| *** serverascode has quit IRC | 23:51 | |
| *** robcresswell has quit IRC | 23:51 | |
| *** mugsie has quit IRC | 23:51 | |
| *** carl_baldwin has quit IRC | 23:51 | |
| *** patrickeast has quit IRC | 23:51 | |
| *** ankur-gupta-f4 has quit IRC | 23:51 | |
| *** samueldmq has quit IRC | 23:51 | |
| *** v1k0d3n has quit IRC | 23:51 | |
| *** fungi has quit IRC | 23:51 | |
| *** johnsom has quit IRC | 23:51 | |
| *** jungleboyj has quit IRC | 23:51 | |
| *** wolsen has quit IRC | 23:51 | |
| *** madorn has quit IRC | 23:51 | |
| *** DinaBelova has quit IRC | 23:51 | |
| *** pots has quit IRC | 23:51 | |
| *** katyafervent_awa has quit IRC | 23:51 | |
| *** ianychoi has quit IRC | 23:51 | |
| *** mtreinish has quit IRC | 23:51 | |
| *** igordc has quit IRC | 23:51 | |
| *** yuval has quit IRC | 23:51 | |
| *** loquacities has quit IRC | 23:51 | |
| *** smcginnis has quit IRC | 23:51 | |
| *** ChanServ has quit IRC | 23:51 | |
| *** gaurangt has quit IRC | 23:51 | |
| *** tdasilva has quit IRC | 23:51 | |
| *** tbarron has quit IRC | 23:51 | |
| *** masayukig has quit IRC | 23:51 | |
| *** stevemar has quit IRC | 23:51 | |
| *** stephenfin has quit IRC | 23:51 | |
| *** setuid has quit IRC | 23:51 | |
| *** PagliaccisCloud has quit IRC | 23:51 | |
| *** mordred has quit IRC | 23:51 | |
| *** masteinhauser has quit IRC | 23:51 | |
| *** kmARC has quit IRC | 23:51 | |
| *** kmARC has joined #openstack-doc | 23:55 | |
| *** setuid has joined #openstack-doc | 23:55 | |
| *** mordred has joined #openstack-doc | 23:55 | |
| *** gouthamr has joined #openstack-doc | 23:55 | |
| *** yamamoto has joined #openstack-doc | 23:55 | |
| *** shaunm has joined #openstack-doc | 23:55 | |
| *** d0ugal has joined #openstack-doc | 23:55 | |
| *** annegentle has joined #openstack-doc | 23:55 | |
| *** emagana has joined #openstack-doc | 23:55 | |
| *** bsilverman_ has joined #openstack-doc | 23:55 | |
| *** rbowen has joined #openstack-doc | 23:55 | |
| *** chlong_ has joined #openstack-doc | 23:55 | |
| *** yangyapeng has joined #openstack-doc | 23:55 | |
| *** krtaylor has joined #openstack-doc | 23:55 | |
| *** AJaeger has joined #openstack-doc | 23:55 | |
| *** Dinesh_Bhor has joined #openstack-doc | 23:55 | |
| *** bswartz has joined #openstack-doc | 23:55 | |
| *** oanson has joined #openstack-doc | 23:55 | |
| *** simonmcc has joined #openstack-doc | 23:55 | |
| *** betherly has joined #openstack-doc | 23:55 | |
| *** berendt has joined #openstack-doc | 23:55 | |
| *** timsim has joined #openstack-doc | 23:55 | |
| *** TheJulia has joined #openstack-doc | 23:55 | |
| *** madorn has joined #openstack-doc | 23:55 | |
| *** junbo has joined #openstack-doc | 23:55 | |
| *** DinaBelova has joined #openstack-doc | 23:55 | |
| *** larainema has joined #openstack-doc | 23:55 | |
| *** mpranjic has joined #openstack-doc | 23:55 | |
| *** odyssey4me has joined #openstack-doc | 23:55 | |
| *** Qiming has joined #openstack-doc | 23:55 | |
| *** serverascode has joined #openstack-doc | 23:55 | |
| *** asettle has joined #openstack-doc | 23:55 | |
| *** mfisch` has joined #openstack-doc | 23:55 | |
| *** sambetts|afk has joined #openstack-doc | 23:55 | |
| *** reed has joined #openstack-doc | 23:55 | |
| *** dims has joined #openstack-doc | 23:55 | |
| *** robcresswell has joined #openstack-doc | 23:55 | |
| *** seongsoocho has joined #openstack-doc | 23:55 | |
| *** mugsie has joined #openstack-doc | 23:55 | |
| *** dhellmann has joined #openstack-doc | 23:55 | |
| *** uberjay has joined #openstack-doc | 23:55 | |
| *** med_ has joined #openstack-doc | 23:55 | |
| *** notmyname has joined #openstack-doc | 23:55 | |
| *** sgordon has joined #openstack-doc | 23:55 | |
| *** gaurangt has joined #openstack-doc | 23:55 | |
| *** cburgess has joined #openstack-doc | 23:55 | |
| *** alex_xu has joined #openstack-doc | 23:55 | |
| *** fungi has joined #openstack-doc | 23:55 | |
| *** tdasilva has joined #openstack-doc | 23:55 | |
| *** ildikov has joined #openstack-doc | 23:55 | |
| *** carl_baldwin has joined #openstack-doc | 23:55 | |
| *** ankur-gupta-f4 has joined #openstack-doc | 23:55 | |
| *** patrickeast has joined #openstack-doc | 23:55 | |
| *** samueldmq has joined #openstack-doc | 23:55 | |
| *** tbarron has joined #openstack-doc | 23:55 | |
| *** jeblair has joined #openstack-doc | 23:55 | |
| *** v1k0d3n has joined #openstack-doc | 23:55 | |
| *** tonyb has joined #openstack-doc | 23:55 | |
| *** mhayden has joined #openstack-doc | 23:55 | |
| *** masayukig has joined #openstack-doc | 23:55 | |
| *** johnthetubaguy has joined #openstack-doc | 23:55 | |
| *** andymccr has joined #openstack-doc | 23:55 | |
| *** jungleboyj has joined #openstack-doc | 23:55 | |
| *** laurelm has joined #openstack-doc | 23:55 | |
| *** ericyoung has joined #openstack-doc | 23:55 | |
| *** EmilienM has joined #openstack-doc | 23:55 | |
| *** wolsen has joined #openstack-doc | 23:55 | |
| *** kencjohnston_ has joined #openstack-doc | 23:55 | |
| *** bradjones has joined #openstack-doc | 23:55 | |
| *** johnsom has joined #openstack-doc | 23:55 | |
| *** pots has joined #openstack-doc | 23:55 | |
| *** ChanServ has joined #openstack-doc | 23:56 | |
| *** tepper.freenode.net sets mode: +o ChanServ | 23:56 | |
| *** openstackgerrit has joined #openstack-doc | 23:56 | |
| *** chason has joined #openstack-doc | 23:56 | |
| *** csatari has joined #openstack-doc | 23:56 | |
| *** mrmartin has joined #openstack-doc | 23:56 | |
| *** masteinhauser has joined #openstack-doc | 23:56 | |
| *** katyafervent_awa has joined #openstack-doc | 23:56 | |
| *** ianychoi has joined #openstack-doc | 23:56 | |
| *** mtreinish has joined #openstack-doc | 23:56 | |
| *** igordc has joined #openstack-doc | 23:56 | |
| *** yuval has joined #openstack-doc | 23:56 | |
| *** loquacities has joined #openstack-doc | 23:56 | |
| *** smcginnis has joined #openstack-doc | 23:56 | |
| *** ChanServ has quit IRC | 23:56 | |
| *** chlong_ has quit IRC | 23:57 | |
| *** yangyapeng has quit IRC | 23:57 | |
| *** med_ has quit IRC | 23:57 | |
| *** alex_xu has quit IRC | 23:57 | |
| *** katyafervent_awa has quit IRC | 23:57 | |
| *** ianychoi has quit IRC | 23:57 | |
| *** mtreinish has quit IRC | 23:57 | |
| *** igordc has quit IRC | 23:57 | |
| *** yuval has quit IRC | 23:57 | |
| *** loquacities has quit IRC | 23:57 | |
| *** smcginnis has quit IRC | 23:57 | |
| *** openstackgerrit has quit IRC | 23:57 | |
| *** chason has quit IRC | 23:57 | |
| *** csatari has quit IRC | 23:57 | |
| *** mrmartin has quit IRC | 23:57 | |
| *** gouthamr has quit IRC | 23:57 | |
| *** annegentle has quit IRC | 23:57 | |
| *** krtaylor has quit IRC | 23:57 | |
| *** AJaeger has quit IRC | 23:57 | |
| *** Dinesh_Bhor has quit IRC | 23:57 | |
| *** shaunm has quit IRC | 23:57 | |
| *** bswartz has quit IRC | 23:57 | |
| *** odyssey4me has quit IRC | 23:57 | |
| *** reed has quit IRC | 23:57 | |
| *** cburgess has quit IRC | 23:57 | |
| *** kmARC has quit IRC | 23:57 | |
| *** d0ugal has quit IRC | 23:57 | |
| *** larainema has quit IRC | 23:57 | |
| *** asettle has quit IRC | 23:57 | |
| *** dims has quit IRC | 23:57 | |
| *** seongsoocho has quit IRC | 23:57 | |
| *** uberjay has quit IRC | 23:57 | |
| *** andymccr has quit IRC | 23:57 | |
| *** laurelm has quit IRC | 23:57 | |
| *** sgordon has quit IRC | 23:57 | |
| *** EmilienM has quit IRC | 23:57 | |
| *** bsilverman_ has quit IRC | 23:57 | |
| *** rbowen has quit IRC | 23:57 | |
| *** oanson has quit IRC | 23:57 | |
| *** mpranjic has quit IRC | 23:57 | |
| *** mfisch` has quit IRC | 23:57 | |
| *** sambetts|afk has quit IRC | 23:57 | |
| *** jeblair has quit IRC | 23:57 | |
| *** tonyb has quit IRC | 23:57 | |
| *** mhayden has quit IRC | 23:57 | |
| *** johnthetubaguy has quit IRC | 23:57 | |
| *** ericyoung has quit IRC | 23:57 | |
| *** bradjones has quit IRC | 23:57 | |
| *** masteinhauser has quit IRC | 23:57 | |
| *** setuid has quit IRC | 23:57 | |
| *** mordred has quit IRC | 23:57 | |
| *** emagana has quit IRC | 23:57 | |
| *** junbo has quit IRC | 23:57 | |
| *** dhellmann has quit IRC | 23:57 | |
| *** notmyname has quit IRC | 23:57 | |
| *** ildikov has quit IRC | 23:57 | |
| *** kencjohnston_ has quit IRC | 23:57 | |
| *** yamamoto has quit IRC | 23:57 | |
| *** betherly has quit IRC | 23:57 | |
| *** simonmcc has quit IRC | 23:57 | |
| *** timsim has quit IRC | 23:57 | |
| *** berendt has quit IRC | 23:57 | |
| *** TheJulia has quit IRC | 23:57 | |
| *** Qiming has quit IRC | 23:57 | |
| *** serverascode has quit IRC | 23:57 | |
| *** robcresswell has quit IRC | 23:57 | |
| *** mugsie has quit IRC | 23:57 | |
| *** carl_baldwin has quit IRC | 23:57 | |
| *** patrickeast has quit IRC | 23:57 | |
| *** ankur-gupta-f4 has quit IRC | 23:57 | |
| *** samueldmq has quit IRC | 23:57 | |
| *** v1k0d3n has quit IRC | 23:57 | |
| *** fungi has quit IRC | 23:57 | |
| *** johnsom has quit IRC | 23:57 | |
| *** jungleboyj has quit IRC | 23:57 | |
| *** wolsen has quit IRC | 23:57 | |
| *** madorn has quit IRC | 23:57 | |
| *** DinaBelova has quit IRC | 23:57 | |
| *** pots has quit IRC | 23:57 | |
| *** gaurangt has quit IRC | 23:57 | |
| *** tdasilva has quit IRC | 23:57 | |
| *** tbarron has quit IRC | 23:57 | |
| *** masayukig has quit IRC | 23:57 | |
Generated by irclog2html.py 2.15.3 by Marius Gedminas - find it at mg.pov.lt!