*** oanson has joined #openstack-doc | 00:01 | |
*** masaki has joined #openstack-doc | 00:02 | |
*** gmann has quit IRC | 00:11 | |
*** gmann has joined #openstack-doc | 00:11 | |
*** tosky has quit IRC | 00:28 | |
*** annegentle has joined #openstack-doc | 00:29 | |
*** dfflanders has joined #openstack-doc | 00:29 | |
*** thorst has quit IRC | 00:45 | |
*** edmondsw has joined #openstack-doc | 00:49 | |
*** edmondsw has quit IRC | 00:53 | |
*** oanson has quit IRC | 00:54 | |
*** oanson has joined #openstack-doc | 00:56 | |
*** annegentle has quit IRC | 01:19 | |
*** thorst has joined #openstack-doc | 01:28 | |
*** thorst has quit IRC | 01:28 | |
openstackgerrit | Merged openstack/security-doc master: Rework the 'node hardening' section https://review.openstack.org/482231 | 01:29 |
---|---|---|
openstackgerrit | Merged openstack/openstack-manuals master: link to in-tree API documentation https://review.openstack.org/482188 | 01:36 |
*** bsilverman_ has quit IRC | 01:37 | |
*** annegentle has joined #openstack-doc | 01:38 | |
*** bsilverman_ has joined #openstack-doc | 01:38 | |
*** charcol has quit IRC | 01:38 | |
*** annegentle has quit IRC | 01:39 | |
*** charcol has joined #openstack-doc | 01:39 | |
*** tonytan_brb has joined #openstack-doc | 01:49 | |
*** caoyuan has joined #openstack-doc | 01:50 | |
*** tonytan4ever has quit IRC | 01:52 | |
*** dmacpher has joined #openstack-doc | 02:08 | |
*** edmondsw has joined #openstack-doc | 02:37 | |
*** edmondsw has quit IRC | 02:42 | |
*** caoyuan_ has joined #openstack-doc | 02:51 | |
*** caoyuan has quit IRC | 02:54 | |
*** tonytan_brb has quit IRC | 02:58 | |
*** yamamoto has joined #openstack-doc | 02:58 | |
*** tonytan4ever has joined #openstack-doc | 03:28 | |
*** thorst has joined #openstack-doc | 03:29 | |
*** dmacpher has quit IRC | 03:29 | |
*** dmacpher has joined #openstack-doc | 03:33 | |
*** thorst has quit IRC | 03:34 | |
*** emagana has joined #openstack-doc | 03:41 | |
*** fragatin_ has joined #openstack-doc | 03:51 | |
*** fragatin_ has quit IRC | 03:52 | |
*** fragatin_ has joined #openstack-doc | 03:52 | |
*** fragatina has quit IRC | 03:54 | |
*** tonytan4ever has quit IRC | 03:57 | |
*** fragatin_ has quit IRC | 03:57 | |
*** cathrich_ has joined #openstack-doc | 03:58 | |
*** cathrichardson has quit IRC | 03:58 | |
*** fragatina has joined #openstack-doc | 04:05 | |
*** fragatina has quit IRC | 04:09 | |
*** adreznec has quit IRC | 04:13 | |
*** adreznec has joined #openstack-doc | 04:14 | |
*** emagana has quit IRC | 04:23 | |
*** emagana has joined #openstack-doc | 04:24 | |
*** edmondsw has joined #openstack-doc | 04:25 | |
*** emagana_ has joined #openstack-doc | 04:26 | |
*** emagana has quit IRC | 04:28 | |
*** edmondsw has quit IRC | 04:30 | |
*** emagana_ has quit IRC | 04:31 | |
*** emagana has joined #openstack-doc | 04:32 | |
*** emagana has quit IRC | 04:36 | |
AJaeger | notmyname: you can have a link from x to y - a static one, update openstack-manuals/www/.htaccess and add one. | 04:58 |
notmyname | for a custom 404? | 04:58 |
notmyname | or for a redirect? | 04:59 |
notmyname | I realized that the plan is in fact to break the existing links | 05:00 |
AJaeger | for a redirect | 05:03 |
AJaeger | yes, those are already broken - changes are too massive overall | 05:04 |
openstackgerrit | Merged openstack/openstack-manuals master: add libraries to list of configuration reference guides https://review.openstack.org/482263 | 05:15 |
openstackgerrit | Merged openstack/openstack-manuals master: remove the cli-ref from openstack-manuals https://review.openstack.org/481092 | 05:15 |
openstackgerrit | Merged openstack/openstack-manuals master: remove links to cli-reference from template pages https://review.openstack.org/481096 | 05:15 |
openstackgerrit | Merged openstack/openstack-manuals master: redirect cli-reference to python-openstackclient https://review.openstack.org/482220 | 05:15 |
*** cathrich_ has quit IRC | 05:15 | |
*** cathrichardson has joined #openstack-doc | 05:17 | |
*** d0ugal has joined #openstack-doc | 05:22 | |
*** thorst has joined #openstack-doc | 05:30 | |
*** thorst has quit IRC | 05:34 | |
*** amotoki_away is now known as amotoki | 05:35 | |
*** ianychoi has joined #openstack-doc | 05:40 | |
*** rcernin has joined #openstack-doc | 05:41 | |
*** katyafervent_awa has quit IRC | 05:44 | |
*** katyafervent_awa has joined #openstack-doc | 05:44 | |
*** d0ugal has quit IRC | 05:52 | |
*** nicolasbock has joined #openstack-doc | 05:55 | |
*** masaki has quit IRC | 06:02 | |
*** masaki has joined #openstack-doc | 06:02 | |
*** pcaruana has joined #openstack-doc | 06:04 | |
*** edmondsw has joined #openstack-doc | 06:14 | |
*** edmondsw has quit IRC | 06:18 | |
openstackgerrit | OpenStack Proposal Bot proposed openstack/security-doc master: Imported Translations from Zanata https://review.openstack.org/482418 | 06:40 |
*** emagana has joined #openstack-doc | 06:44 | |
*** belmoreira has joined #openstack-doc | 06:46 | |
*** emagana has quit IRC | 06:48 | |
*** suyog has quit IRC | 06:49 | |
*** egallen has joined #openstack-doc | 06:49 | |
*** tesseract has joined #openstack-doc | 07:02 | |
*** dfflanders has quit IRC | 07:18 | |
*** jpena|off is now known as jpena | 07:19 | |
*** fragatina has joined #openstack-doc | 07:27 | |
*** mriedem has quit IRC | 07:30 | |
openstackgerrit | OpenStack Proposal Bot proposed openstack/training-guides master: Imported Translations from Zanata https://review.openstack.org/482432 | 07:31 |
*** thorst has joined #openstack-doc | 07:31 | |
*** egallen has quit IRC | 07:32 | |
*** fragatina has quit IRC | 07:32 | |
*** openstackgerrit has quit IRC | 07:33 | |
*** thorst has quit IRC | 07:36 | |
*** egallen has joined #openstack-doc | 08:07 | |
*** openstackgerrit has joined #openstack-doc | 08:52 | |
openstackgerrit | Rob Cresswell proposed openstack/openstackdocstheme master: Add support for versionadded and deprecated https://review.openstack.org/482265 | 08:52 |
*** phuongnh has joined #openstack-doc | 08:56 | |
*** tosky has joined #openstack-doc | 08:59 | |
*** masaki has quit IRC | 09:02 | |
*** vijaykc4 has joined #openstack-doc | 09:15 | |
*** thorst has joined #openstack-doc | 09:32 | |
*** Aqsa has joined #openstack-doc | 09:35 | |
*** thorst has quit IRC | 09:37 | |
*** edmondsw has joined #openstack-doc | 09:50 | |
*** vijaykc4 has quit IRC | 09:50 | |
*** vijaykc4 has joined #openstack-doc | 09:51 | |
*** d0ugal has joined #openstack-doc | 09:52 | |
*** edmondsw has quit IRC | 09:54 | |
*** d0ugal has quit IRC | 09:59 | |
*** yamamoto has quit IRC | 10:03 | |
*** vijaykc4 has quit IRC | 10:04 | |
*** caoyuan_ has quit IRC | 10:05 | |
*** phuongnh has quit IRC | 10:08 | |
Aqsa | asettle: Can you kindly tell me where the code for wiki page of OpenStack is hosted? | 10:22 |
openstackgerrit | Rob Cresswell proposed openstack/openstackdocstheme master: Add support for versionadded and deprecated https://review.openstack.org/482265 | 10:25 |
*** gouthamr has quit IRC | 10:33 | |
*** gouthamr has joined #openstack-doc | 10:41 | |
*** egallen has quit IRC | 10:44 | |
*** egallen has joined #openstack-doc | 10:44 | |
*** egallen has quit IRC | 10:44 | |
*** egallen has joined #openstack-doc | 10:45 | |
*** egallen has quit IRC | 10:45 | |
*** egallen has joined #openstack-doc | 10:46 | |
*** egallen has quit IRC | 10:46 | |
*** egallen has joined #openstack-doc | 10:46 | |
*** egallen has quit IRC | 10:47 | |
*** egallen has joined #openstack-doc | 10:47 | |
*** egallen has quit IRC | 10:48 | |
*** thorst has joined #openstack-doc | 10:50 | |
*** pkovar has joined #openstack-doc | 10:57 | |
tosky | apart from this: https://review.openstack.org/#/c/474543/ there are other examples of import/migration of configuration reference? | 11:03 |
AJaeger | Aqsa: what exactly do you need? | 11:03 |
*** vijaykc4 has joined #openstack-doc | 11:03 | |
*** yamamoto has joined #openstack-doc | 11:04 | |
AJaeger | tosky: whenever I see such patches I chagne the topic to doc-migration ;) | 11:06 |
AJaeger | tosky looking through doc-migration I spoted https://review.openstack.org/#/c/478597/ and https://review.openstack.org/#/c/473560/ | 11:08 |
AJaeger | tosky: and then I asked gerrit, like https://review.openstack.org/#/q/topic:doc-migration+file:doc/source/configuration/index.rst | 11:09 |
*** yamamoto has quit IRC | 11:11 | |
*** vijaykc4 has quit IRC | 11:13 | |
tosky | AJaeger: thanks - I tried to go through the patches marked as doc-migration, but I failed to find many with "config" in the subject | 11:17 |
tosky | and I didn't know about file: as search filter | 11:18 |
AJaeger | yeah, file is really cool in this context ;) | 11:20 |
*** vijaykc4 has joined #openstack-doc | 11:23 | |
*** yamamoto has joined #openstack-doc | 11:30 | |
*** egallen has joined #openstack-doc | 11:32 | |
*** edmondsw has joined #openstack-doc | 11:38 | |
*** edmondsw has quit IRC | 11:42 | |
*** vijaykc4 has quit IRC | 11:45 | |
*** vijaykc4 has joined #openstack-doc | 12:01 | |
Aqsa | AJaeger: The operations guide has to be moved to wiki page. I am not sure where exactly this change will have to be merged. | 12:03 |
*** vijaykc4 has quit IRC | 12:06 | |
*** vijaykc4 has joined #openstack-doc | 12:06 | |
*** dustins has joined #openstack-doc | 12:09 | |
*** caoyuan has joined #openstack-doc | 12:10 | |
AJaeger | Aqsa: that's what the person doing the migration has to come up with http://wiki.openstack.org/ is the wiki - and uses mediawiki, so adding content is done via a browser | 12:12 |
*** jpena is now known as jpena|lunch | 12:16 | |
*** pkovar has quit IRC | 12:35 | |
openstackgerrit | Merged openstack/openstack-manuals master: use the governance data to build the redirect list for /latest/ https://review.openstack.org/481172 | 12:35 |
*** yamamoto has quit IRC | 12:38 | |
*** caoyuan_ has joined #openstack-doc | 12:41 | |
*** caoyuan has quit IRC | 12:41 | |
*** edmondsw has joined #openstack-doc | 12:46 | |
*** openstackgerrit has quit IRC | 12:47 | |
*** charcol has quit IRC | 12:59 | |
*** charcol has joined #openstack-doc | 12:59 | |
*** vijaykc4 has quit IRC | 13:00 | |
*** vijaykc4 has joined #openstack-doc | 13:00 | |
*** matjazp has joined #openstack-doc | 13:02 | |
*** pkovar has joined #openstack-doc | 13:02 | |
*** cathrich_ has joined #openstack-doc | 13:13 | |
*** cathrichardson has quit IRC | 13:16 | |
*** emagana has joined #openstack-doc | 13:19 | |
*** emagana has quit IRC | 13:24 | |
*** yamamoto has joined #openstack-doc | 13:25 | |
*** jpena|lunch is now known as jpena | 13:27 | |
*** fragatina has joined #openstack-doc | 13:28 | |
*** alexchadin has joined #openstack-doc | 13:29 | |
*** fragatina has quit IRC | 13:33 | |
mpranjic | hello | 13:34 |
mpranjic | man, it is weird going to vacation... takes some time to get the strings back :) | 13:35 |
*** fragatina has joined #openstack-doc | 13:36 | |
*** fragatina has quit IRC | 13:36 | |
*** fragatina has joined #openstack-doc | 13:36 | |
dhellmann | notmyname : links to /developer/swift/.* should be redirecting to /swift/latest/ but they won't necessarily go directly to the page in question because we can't predict where that will be (some of the content under /developer/$project moves to the install directory, some to contributor, etc.). If you have a redirect that's not working as expected, let me know and I'll see if I can work out why. | 13:39 |
mpranjic | AJaeger: reviews will be done for wiki code too? | 13:41 |
dhellmann | mpranjic : the proposal was for the operator community to take ownership of the operators' guide and move it to the wiki. The process for doing that will be up to the people who volunteer to do it. | 13:43 |
amotoki | dhellmann: asettle: do we need to apply the doc-migration work to openstack-dev projects like hacking? | 13:43 |
dhellmann | asettle , AJaeger : o/ | 13:43 |
dhellmann | amotoki : eventually it would be good to do that, but they are less of a priority than other the projects | 13:43 |
dhellmann | s/other the/the other/ | 13:44 |
amotoki | at now, /developer/hacking and /hacking/latest are both dead | 13:44 |
dhellmann | we probably haven't landed a patch in that repo | 13:44 |
dhellmann | I'm going to work with fungi this week or next week to move any old html from /developer for projects that have nothing under the new structure | 13:45 |
dhellmann | amotoki : https://review.openstack.org/481710 | 13:45 |
amotoki | I was asked whether we should update the hacking url when reviewing a patch to update URLs in README or similar thing | 13:45 |
dhellmann | yes, that probably makes sense to do. we left out the step to update URLs in README files. | 13:46 |
*** egallen has quit IRC | 13:47 | |
amotoki | dhellmann: thanks. it makes sense, but it seems better not to rush sending a patch of updating doc URLs | 13:47 |
*** egallen has joined #openstack-doc | 13:47 | |
*** egallen has quit IRC | 13:48 | |
*** egallen has joined #openstack-doc | 13:48 | |
*** egallen has quit IRC | 13:48 | |
mpranjic | dhellmann: makes sense | 13:49 |
dhellmann | amotoki : yes, I agree. We do have redirects in place. | 13:49 |
*** egallen has joined #openstack-doc | 13:49 | |
mpranjic | I am doing wiki on several projects for years. I can help. | 13:49 |
*** egallen has quit IRC | 13:49 | |
dhellmann | mpranjic: that would be good. you probably want to coordinate with asettle; I'm not sure if anyone else has volunteered so far. | 13:49 |
*** egallen has joined #openstack-doc | 13:50 | |
*** egallen has quit IRC | 13:50 | |
*** egallen has joined #openstack-doc | 13:50 | |
*** gcb has joined #openstack-doc | 13:51 | |
mpranjic | asettle: ! :) | 13:51 |
mpranjic | dhellmann: will do thnx. | 13:51 |
*** egallen has quit IRC | 13:51 | |
*** egallen has joined #openstack-doc | 13:51 | |
mpranjic | I am on vacation atm. a bit wild here with limited access, but can start slowly soon, I think | 13:51 |
*** egallen has quit IRC | 13:52 | |
*** egallen has joined #openstack-doc | 13:52 | |
*** egallen has quit IRC | 13:52 | |
*** egallen has joined #openstack-doc | 13:53 | |
*** egallen has quit IRC | 13:53 | |
*** d0ugal has joined #openstack-doc | 13:54 | |
*** egallen has joined #openstack-doc | 13:54 | |
*** egallen has quit IRC | 13:54 | |
AJaeger | mpranjic: there'S no wiki *code*. And a wiki comes without reviews. | 13:55 |
AJaeger | mpranjic: there was some email on openstack-ops mailing list, best to follow up there (last month?) | 13:56 |
*** openstackgerrit has joined #openstack-doc | 14:00 | |
openstackgerrit | Helen Walsh proposed openstack/openstack-manuals stable/ocata: VMAX driver - typo fixes and clarification to Ocata manuals https://review.openstack.org/482575 | 14:00 |
*** d0ugal has quit IRC | 14:00 | |
*** rbowen has quit IRC | 14:01 | |
asettle | mpranjic: here now! Sorry, was in transit today | 14:02 |
asettle | dhellmann and AJaeger - mpranjic did email me a while back volunteering, which I forwarded to the ops list. There was one other individual who offered to help in a patch | 14:02 |
asettle | I'd have ot go back and have a look and find | 14:02 |
*** rbowen has joined #openstack-doc | 14:03 | |
gcb | dhellmann: should we finish the work of ' update the link to the documentation in your README, setup.cfg and other documentations to point to the new location' for oslo before next week ? | 14:03 |
mpranjic | AJaeger: I thought as much. just wanted to double-check what wasa the idea | 14:06 |
mpranjic | asettle: I was busy with some projects and vas drawn into the deserted places (vacation time), so I lag a bit | 14:07 |
mpranjic | but it will get better :) | 14:07 |
AJaeger | asettle: Aqsa was asking earlier as well | 14:11 |
mpranjic | do we have some timeline, deadline or anything similar? | 14:13 |
openstackgerrit | Doug Hellmann proposed openstack/openstack-manuals master: link to list of api guides from main page https://review.openstack.org/482578 | 14:17 |
asettle | AJaeger and mpranjic just on a meeting, but yes, the deadline is essentially Pike | 14:19 |
asettle | Which is last week August | 14:19 |
*** ykarel has joined #openstack-doc | 14:20 | |
ykarel | AJaeger, sorry didn't new about this channel | 14:20 |
AJaeger | ykarel: it was announced in dhellmann's updates about doc-migration work | 14:21 |
AJaeger | ykarel: your question is answered in http://specs.openstack.org/openstack/docs-specs/specs/pike/os-manuals-migration.html | 14:21 |
AJaeger | "docs.openstack.org/$project-name/$series – build from stable/$series" | 14:21 |
dhellmann | gcb : if we can, yes. but we should have redirects in place for those old doc locations so users will be able to find the documentation | 14:22 |
*** vijaykc4 has quit IRC | 14:22 | |
AJaeger | So, ykarel so merge somethign to ocata or newton so that it gets published on https://docs.openstack.org/magnum/newton | 14:22 |
ykarel | AJaeger, Ok got it | 14:22 |
ykarel | Thanks | 14:22 |
*** yamamoto has quit IRC | 14:24 | |
gcb | dhellmann: okay, I saw the the redirect works. I will check and mark Done for oslo libraries in next days in https://etherpad.openstack.org/p/doc-migration-tracking | 14:24 |
dhellmann | gcb : thank you! | 14:25 |
*** d0ugal has joined #openstack-doc | 14:25 | |
*** d0ugal has quit IRC | 14:31 | |
*** alexchadin has quit IRC | 14:32 | |
openstackgerrit | Doug Hellmann proposed openstack/openstack-manuals master: add flags for a bunch of missing guides https://review.openstack.org/482314 | 14:36 |
openstackgerrit | Doug Hellmann proposed openstack/openstack-manuals master: add a new landing page to list all admin guides https://review.openstack.org/482315 | 14:36 |
openstackgerrit | Doug Hellmann proposed openstack/openstack-manuals master: add flag to www-generator to look for links to enable https://review.openstack.org/482313 | 14:36 |
*** rcernin has quit IRC | 14:38 | |
*** yamamoto has joined #openstack-doc | 14:40 | |
*** rcernin has joined #openstack-doc | 14:40 | |
*** jpena is now known as jpena|off | 14:46 | |
*** openstackgerrit has quit IRC | 14:48 | |
*** openstackgerrit has joined #openstack-doc | 14:48 | |
openstackgerrit | Doug Hellmann proposed openstack/openstack-manuals master: move config-reference.html to /configuration/ https://review.openstack.org/482589 | 14:48 |
*** emagana has joined #openstack-doc | 14:49 | |
*** cathrich_ is now known as cathrichardson | 15:00 | |
*** jpena|off is now known as jpena | 15:13 | |
*** rcernin has quit IRC | 15:18 | |
*** caoyuan_ has quit IRC | 15:20 | |
*** annegentle has joined #openstack-doc | 15:24 | |
*** catintheroof has joined #openstack-doc | 15:28 | |
jungleboyj | dhellmann: Good morning. Quick question for you. | 15:30 |
dhellmann | hi, jungleboyj, good morning | 15:30 |
jungleboyj | dhellmann: I hadn't seen the config-reference in the list of things that I need to migrate but it appears that it was removed from openstack-manuals. | 15:31 |
openstackgerrit | Merged openstack/training-guides master: Imported Translations from Zanata https://review.openstack.org/482432 | 15:33 |
dhellmann | jungleboyj : yes, the old static content should be replaced with pages using oslo.config's sphinxext module to generate tables automatically | 15:34 |
dhellmann | jungleboyj : https://docs.openstack.org/oslo.config/latest/reference/sphinxext.html | 15:35 |
dhellmann | jungleboyj : here's a patch from sjain for keystone: https://review.openstack.org/#/c/479631/ | 15:35 |
*** belmoreira has quit IRC | 15:38 | |
jungleboyj | dhellmann: Ok. Thanks! I will make a comparable change for Cinder. | 15:39 |
jungleboyj | I vaguely remember reading about that somewhere. Anything else that needs to be autogenerated that I might have missed? | 15:40 |
smcginnis | dhellmann, jungleboyj: How is that automatically generated? The tables always were, but there was a lot of extra descriptions and notes for each driver. | 15:42 |
dhellmann | jungleboyj : there's a similar extension for policy in oslo.policy (that keystone patch uses it, too, I think) | 15:43 |
jungleboyj | Ok. | 15:43 |
dhellmann | smcginnis : if there is useful extra *prose* content in the old guide, that should be copied over | 15:44 |
*** andreas_s has quit IRC | 15:44 | |
setuid | andreas_s: Remind me again when the switch from mvn to tox happened? Was that between liberty-eol and mitaka branches? | 15:44 |
dhellmann | smcginnis, jungleboyj: but the tables in that guide were produced through some automation that we're deprecating (along with the guide itself) | 15:44 |
smcginnis | Yeah, quite a bit of extra prose, for example: https://docs.openstack.org/ocata/config-reference/block-storage/drivers/emc-vmax-driver.html | 15:45 |
jungleboyj | smcginnis: :-( | 15:45 |
dhellmann | ok. that stuff can all go into your /admin or /install guides now | 15:47 |
*** mhayden has quit IRC | 15:48 | |
*** mhayden has joined #openstack-doc | 15:48 | |
jungleboyj | dhellmann: Ok. | 15:51 |
jungleboyj | smcginnis: That is going to take some more thought and effort to do. | 15:52 |
jungleboyj | Lets plan some time to talk about that when we get together tomorrow. | 15:52 |
*** yamamoto has quit IRC | 15:58 | |
*** vijaykc4 has joined #openstack-doc | 16:04 | |
*** ykarel has quit IRC | 16:04 | |
*** ykarel has joined #openstack-doc | 16:05 | |
*** mriedem has joined #openstack-doc | 16:11 | |
*** annegentle has quit IRC | 16:13 | |
*** amotoki is now known as amotoki_away | 16:14 | |
*** annegentle has joined #openstack-doc | 16:17 | |
*** edmondsw has quit IRC | 16:17 | |
*** ykarel has quit IRC | 16:19 | |
*** edmondsw_ has joined #openstack-doc | 16:19 | |
*** edmondsw_ has quit IRC | 16:23 | |
openstackgerrit | Helen Walsh proposed openstack/openstack-manuals stable/ocata: VMAX driver - typo fixes and clarification to Ocata manuals https://review.openstack.org/482575 | 16:50 |
*** yamamoto has joined #openstack-doc | 16:59 | |
*** yamamoto has quit IRC | 17:04 | |
*** pkovar has quit IRC | 17:10 | |
*** jpena is now known as jpena|off | 17:13 | |
*** jpena|off has quit IRC | 17:14 | |
*** vijaykc4 has quit IRC | 17:27 | |
*** edmondsw has joined #openstack-doc | 17:35 | |
*** matjazp has quit IRC | 17:39 | |
*** tosky has quit IRC | 17:41 | |
openstackgerrit | Doug Hellmann proposed openstack/openstack-manuals master: move config-reference.html to /configuration/ https://review.openstack.org/482589 | 17:43 |
openstackgerrit | Doug Hellmann proposed openstack/openstack-manuals master: link to list of api guides from main page https://review.openstack.org/482578 | 17:43 |
openstackgerrit | Doug Hellmann proposed openstack/openstack-manuals master: add validation requiring clients to have a description value https://review.openstack.org/482275 | 17:48 |
openstackgerrit | Doug Hellmann proposed openstack/openstack-manuals master: sort libraries by service description https://review.openstack.org/482277 | 17:48 |
openstackgerrit | Doug Hellmann proposed openstack/openstack-manuals master: shorten the shade description https://review.openstack.org/482276 | 17:48 |
*** Aqsa has quit IRC | 17:50 | |
mordred | dhellmann: ah - I see the thing you're solving now | 17:56 |
*** annegentle has quit IRC | 17:58 | |
*** annegentle has joined #openstack-doc | 17:59 | |
AJaeger | dhellmann: I'll do a major surgery on .htaccess now - stay tuned... | 18:01 |
dhellmann | mordred : with the description? | 18:02 |
dhellmann | AJaeger : ack | 18:02 |
*** yamamoto has joined #openstack-doc | 18:02 | |
*** tosky has joined #openstack-doc | 18:07 | |
*** yamamoto has quit IRC | 18:07 | |
openstackgerrit | Andreas Jaeger proposed openstack/openstack-manuals master: Remove old redirects from .htaccess https://review.openstack.org/482656 | 18:15 |
AJaeger | dhellmann: ^ | 18:16 |
AJaeger | see alsoe the first 10 lines of the file, those are redirects for anything like /bexar - so not sense to move any bexar subdir around... | 18:17 |
dhellmann | good point | 18:18 |
*** vijaykc4 has joined #openstack-doc | 18:18 | |
* AJaeger removes some duplicates - shortening the file showed this | 18:19 | |
*** edmondsw_ has joined #openstack-doc | 18:23 | |
*** tesseract has quit IRC | 18:25 | |
*** edmondsw has quit IRC | 18:25 | |
setuid | Ok, who broke the mitaka doc branch? | 18:31 |
setuid | $ tox -e bindep | 18:31 |
setuid | ERROR: unknown environment 'bindep' | 18:31 |
setuid | grrr | 18:31 |
setuid | This was working 2 weeks ago | 18:31 |
AJaeger | setuid: no | 18:31 |
AJaeger | I doubt that we added bindep to mitaka, only to newer branches | 18:32 |
AJaeger | setuid: are you sure you're on mitaka branch? | 18:32 |
setuid | hrm.. ok, one sec | 18:32 |
setuid | yep, on the mitaka branch | 18:32 |
setuid | mitaka-eol | 18:32 |
AJaeger | and we didn't merge anything to mitaka for some time... | 18:32 |
mpranjic | asettle: well, we have a lot to do then :) | 18:33 |
openstackgerrit | Andreas Jaeger proposed openstack/openstack-manuals master: Remove old redirects from .htaccess https://review.openstack.org/482656 | 18:33 |
setuid | AJaeger: I'm just trying to offer $CLIENT a solution to these missing docs | 18:33 |
setuid | Pulling a clean clone now | 18:33 |
AJaeger | setuid: which missing *mitaka* docs? | 18:34 |
setuid | All the eol branches, have missing docs upstream, so I'm giving $CLIENT a temporary workaround by patching the branches to build local copoies | 18:34 |
setuid | liberty-eol is patched and works, for building a local copy, working on mitaka now | 18:34 |
AJaeger | setuid: we have all mitaka docs up | 18:35 |
AJaeger | http://docs.openstack.org/mitaka/config-reference/ https://docs.openstack.org/mitaka/install-guide-ubuntu/ are both there | 18:35 |
setuid | Understood, I'm working on a contingency plan, for when those get pulled (like liberty, kilo, etfc. did) | 18:35 |
setuid | the mitaka-eol branch has a tox.ini in it, so someone was building it with tox | 18:35 |
AJaeger | yes, it has tox. but no bindep that was added later | 18:36 |
setuid | Ok, so there's another gap here. How does one build mitaka docs from that tag, since maven builds were deprecated? | 18:38 |
setuid | This page implies tox + bindep: https://docs.openstack.org/contributor-guide/docs-builds.html | 18:38 |
setuid | So there's some 'interim' build solution somewhere between mvn and tox? | 18:39 |
AJaeger | setuid: just use tox, mitaka does not use maven | 18:39 |
*** annegentle has quit IRC | 18:39 | |
setuid | So literally just run 'tox' in the clone? | 18:39 |
AJaeger | yes | 18:39 |
setuid | hrm, that's easy :) | 18:39 |
AJaeger | if bindep on master tells you're fine, you should be fine for mitaka as well | 18:39 |
setuid | Looks like some unstated deps are missing, I'll doc them and report it | 18:41 |
openstackgerrit | Doug Hellmann proposed openstack/openstack-manuals master: move admin-guide.html to admin/index.html https://review.openstack.org/482662 | 18:42 |
openstackgerrit | Doug Hellmann proposed openstack/openstack-manuals master: move config-reference.html to /configuration/ https://review.openstack.org/482589 | 18:46 |
openstackgerrit | Doug Hellmann proposed openstack/openstack-manuals master: link to list of api guides from main page https://review.openstack.org/482578 | 18:46 |
AJaeger | dhellmann: what abour redirecting https://docs.openstack.org/admin-guide/.* to the new admin/index.html page ? | 18:46 |
dhellmann | AJaeger : yeah, that's a good idea, too | 18:47 |
openstackgerrit | Doug Hellmann proposed openstack/openstack-manuals master: redirect old admin guide to new landing page https://review.openstack.org/482665 | 18:49 |
dhellmann | AJaeger : ^^ | 18:49 |
dhellmann | we have a lot of stuff in flight; it may be a good idea to land it all then take one pass through and clean it up and add any missing redirects | 18:49 |
*** nicolasbock has quit IRC | 18:50 | |
AJaeger | dhellmann: yeah - I just went through some reviews... | 18:50 |
dhellmann | yeah, I noticed, thanks | 18:50 |
dhellmann | between my changes and your big set of mods to htaccess, I wouldn't be surprised if we have merge conflicts | 18:50 |
AJaeger | there will be for sure ;) | 18:51 |
AJaeger | we'll figure it out :) | 18:51 |
dhellmann | oh, yeah, not a problem, just it might be simpler to get all of that in and then do 1 more fix patch | 18:51 |
dhellmann | AJaeger : we're at 612 reviews with the topic doc-migration | 18:52 |
AJaeger | wow, that's a lot | 18:53 |
AJaeger | dhellmann: agreed, let's see whether asettle is around to do some mass reviewing | 18:53 |
dhellmann | it would be interesting if stackalytics could filter on topic | 18:53 |
AJaeger | :) | 18:54 |
dhellmann | AJaeger : ++ | 18:54 |
setuid | AJaeger: What was the motivation to jump from mvn to tox? | 18:55 |
AJaeger | dhellmann: your change https://review.openstack.org/480730 has -1 by Zuul | 18:55 |
setuid | tox seems a _lot_ more fragile, and requires more deps than maven did | 18:55 |
AJaeger | setuid: We jumped from Docbook XML to RST -. | 18:55 |
setuid | It's tossed in a dozen different ways already on 3 test systems I just tried to build it on, failing on all 3 in random ways | 18:55 |
dhellmann | AJaeger : yeah, I need to sit down and work on that a bit more. mordred has a lib to work with that service-type data, and I should be using that instead of pulling yaml files down myself | 18:55 |
AJaeger | every python dev knows RST - nobody knows DocBook XML | 18:56 |
AJaeger | dhellmann: I see | 18:56 |
mordred | dhellmann: I hope to have that lib done this week - also, I added you as an initial core :) | 18:56 |
dhellmann | AJaeger : maybe I'll have time for it tomorrow | 18:56 |
mordred | dhellmann: welcome to the team | 18:56 |
dhellmann | mordred : oh, goody! :-) | 18:56 |
AJaeger | dhellmann: no worries - just wasn't sure whether you were aware of it | 18:56 |
dhellmann | mordred : which repo should I be watching again? | 18:57 |
dhellmann | AJaeger: yep, thanks | 18:57 |
AJaeger | dhellmann: all of them ;) | 18:57 |
openstackgerrit | Monty Taylor proposed openstack/openstack-manuals master: Distinguish between cloud-wide and per-service apis https://review.openstack.org/482667 | 18:57 |
openstackgerrit | Monty Taylor proposed openstack/openstack-manuals master: Correct pluarity of "Python SDKs" https://review.openstack.org/482668 | 18:57 |
openstackgerrit | Monty Taylor proposed openstack/openstack-manuals master: WIP Advocate more strongly for users to use shade https://review.openstack.org/482669 | 18:57 |
mordred | dhellmann: also -you may have incited me to go poke at the docs repo :) | 18:57 |
setuid | One example: https://paste.debian.net/hidden/ef71a1f6/ | 18:58 |
AJaeger | dhellmann: thanks! | 18:58 |
dhellmann | mordred : the more the merrier! | 18:58 |
AJaeger | setuid: it tries to download a remote file from stable/mitaka I guess - with mitaka-eol, you need to change those to download from mitaka-eol tag instead | 18:59 |
AJaeger | setuid: grep for stable/mitaka and replace | 19:00 |
*** matjazp has joined #openstack-doc | 19:07 | |
dhellmann | AJaeger : will you make it to denver for the ptg? | 19:09 |
*** annegentle has joined #openstack-doc | 19:10 | |
AJaeger | dhellmann: nope | 19:10 |
dhellmann | AJaeger : bummer | 19:10 |
*** fragatina has quit IRC | 19:11 | |
*** Aqsa has joined #openstack-doc | 19:13 | |
*** annegentle has quit IRC | 19:13 | |
*** annegentle has joined #openstack-doc | 19:14 | |
setuid | AJaeger: Right, same fixes we had to do for liberty-eol tags | 19:28 |
setuid | Only 45 of them | 19:28 |
AJaeger | sed to the rescue ;) | 19:28 |
setuid | You want a git diff of rhese, so anyone building from these tags, can? | 19:28 |
setuid | sed won't work that way | 19:28 |
setuid | each file has a different verison, it's all one by one | 19:29 |
annegentle | setuid if you can write up your findings for https://docs.openstack.org/contributor-guide/docs-builds.html#building-docs-from-end-of-life-releases that would be useful! | 19:29 |
AJaeger | sed -e -i 's|stable/mitaka|mitaka-eol|' doc/*/*/... | 19:29 |
AJaeger | hi annegentle, if you have time to merge some of dhellmann's and my changes, it would be nice - we each gave +2 to the others I think... | 19:30 |
annegentle | AJaeger ok, sure | 19:30 |
annegentle | setuid the "tox + bindep" is earlier on that page for current doc builds, building from tags is specific | 19:31 |
setuid | Here's the working diff for liberty-eol, for example: https://paste.debian.net/hidden/c80af360/ | 19:31 |
setuid | perl -pi -e 's,stable/mitaka,mitaka-eol,g' $(find . -type f -name '*.rst' -exec grep -l 'stable/mitaka' {} \;) | 19:32 |
setuid | :) | 19:33 |
annegentle | AJaeger all good to merge name changes, right? | 19:33 |
AJaeger | yep | 19:34 |
setuid | AJaeger: Is it better to work from the eol tag, vs. static file version numbers? | 19:36 |
setuid | eg: the above perl snippet/sed snippet, vs. what I did in the diff in the pastebin above? | 19:36 |
AJaeger | I would go with the EOL tags | 19:37 |
setuid | Ok, fair enough, it'll make for a much smaller set of instructions/diffs | 19:38 |
openstackgerrit | Anne Gentle proposed openstack/openstack-manuals master: add flag to www-generator to look for links to enable https://review.openstack.org/482313 | 19:40 |
annegentle | AJaeger ^^ on that, simply changed help strings, if you could re-look | 19:40 |
*** cathrichardson has quit IRC | 19:46 | |
AJaeger | annegentle: sure - thanks | 19:46 |
*** cathrichardson has joined #openstack-doc | 19:47 | |
annegentle | dhellmann AJaeger I have to say, this programmatic sorting and validation is REALLY cool | 19:47 |
annegentle | I'm excited about it | 19:47 |
dhellmann | :-) | 19:47 |
annegentle | yeah, way nerdy :) | 19:47 |
annegentle | dhellmann Docs ARE Code here :) | 19:47 |
dhellmann | code + data! | 19:48 |
AJaeger | annegentle: agreed - wonder why it took us so long. But we never had to make such massive changes... | 19:49 |
annegentle | AJaeger 500+ patches is a bit intimidating :) | 19:49 |
annegentle | AJaeger so... needed fresh eyes, I guess | 19:49 |
annegentle | :) | 19:49 |
annegentle | AJaeger so great to see all that /trunk/ removal :) https://review.openstack.org/#/c/482656/ | 19:50 |
AJaeger | annegentle: yeah, it's time... | 19:50 |
annegentle | AJaeger ok to merge that? Or wait dhellmann to give another +2? | 19:51 |
AJaeger | dhellmann: I'm surprised that https://review.openstack.org/#/c/482656/ gives no conflicts - do you want to +2? | 19:51 |
* dhellmann looks at the changes | 19:51 | |
AJaeger | annegentle: let's give him a chance ;) | 19:51 |
*** vijaykc4 has quit IRC | 19:51 | |
dhellmann | I just did | 19:51 |
AJaeger | annegentle: so, go ahead with your +2A if you're happy - thanks | 19:52 |
annegentle | dhellmann thanks, merged... | 19:52 |
annegentle | now we wait builds? | 19:52 |
annegentle | await? | 19:52 |
AJaeger | yes - Zuul i sreally busy, we're out of spare nodes... | 19:52 |
annegentle | AJaeger eep. Okay. | 19:53 |
dhellmann | yeah, and the tc meeting is starting soon so I'll be distracted | 19:53 |
dhellmann | I'm going to see about cleaning up the user guide tomorrow | 19:53 |
annegentle | dhellmann AJaeger I think I spotted them all for today, holler if you need anything, getting on a plane later today | 19:53 |
dhellmann | annegentle : safe travels, and thanks! | 19:53 |
AJaeger | annegentle: safe travels! | 19:53 |
openstackgerrit | Merged openstack/openstack-manuals master: add validation requiring clients to have a description value https://review.openstack.org/482275 | 19:53 |
AJaeger | annegentle: looks good, thanks | 19:54 |
openstackgerrit | Merged openstack/openstack-manuals master: shorten the shade description https://review.openstack.org/482276 | 19:54 |
openstackgerrit | Merged openstack/openstack-manuals master: sort libraries by service description https://review.openstack.org/482277 | 19:54 |
AJaeger | dhellmann: might take an hour or more until the publishing is done | 19:55 |
dhellmann | AJaeger : yep | 19:56 |
openstackgerrit | Andreas Jaeger proposed openstack/openstack-manuals master: add flag to www-generator to look for links to enable https://review.openstack.org/482313 | 19:56 |
AJaeger | dhellmann: fixed overlong line and reapproved ^ | 19:57 |
dhellmann | AJaeger : ack, thanks | 19:57 |
*** emagana has quit IRC | 19:59 | |
*** emagana_ has joined #openstack-doc | 20:00 | |
openstackgerrit | Merged openstack/openstack-manuals master: Remove old redirects from .htaccess https://review.openstack.org/482656 | 20:01 |
openstackgerrit | Andreas Jaeger proposed openstack/openstack-manuals master: add flags for a bunch of missing guides https://review.openstack.org/482314 | 20:01 |
AJaeger | dhellmann: I'll take care of your merge conflicts... | 20:02 |
openstackgerrit | Andreas Jaeger proposed openstack/openstack-manuals master: add flag to www-generator to look for links to enable https://review.openstack.org/482313 | 20:05 |
*** edmondsw_ is now known as edmondsw | 20:07 | |
openstackgerrit | Andreas Jaeger proposed openstack/openstack-manuals master: add flags for a bunch of missing guides https://review.openstack.org/482314 | 20:08 |
openstackgerrit | Andreas Jaeger proposed openstack/openstack-manuals master: add a new landing page to list all admin guides https://review.openstack.org/482315 | 20:08 |
openstackgerrit | Andreas Jaeger proposed openstack/openstack-manuals master: redirect old admin guide to new landing page https://review.openstack.org/482665 | 20:08 |
openstackgerrit | Andreas Jaeger proposed openstack/openstack-manuals master: move admin-guide.html to admin/index.html https://review.openstack.org/482662 | 20:08 |
dhellmann | AJaeger : thanks | 20:09 |
*** annegentle has quit IRC | 20:12 | |
*** fragatina has joined #openstack-doc | 20:21 | |
*** annegentle has joined #openstack-doc | 20:25 | |
*** annegentle has quit IRC | 20:33 | |
*** thorst has quit IRC | 20:35 | |
openstackgerrit | Merged openstack/openstack-manuals master: add flag to www-generator to look for links to enable https://review.openstack.org/482313 | 20:37 |
openstackgerrit | Merged openstack/openstack-manuals master: add flags for a bunch of missing guides https://review.openstack.org/482314 | 20:38 |
openstackgerrit | Merged openstack/openstack-manuals master: add a new landing page to list all admin guides https://review.openstack.org/482315 | 20:38 |
openstackgerrit | Merged openstack/openstack-manuals master: move admin-guide.html to admin/index.html https://review.openstack.org/482662 | 20:38 |
openstackgerrit | Merged openstack/openstack-manuals master: redirect old admin guide to new landing page https://review.openstack.org/482665 | 20:39 |
*** Aqsa has quit IRC | 20:40 | |
setuid | wow, tox is a pig when it's building docs, drags my workstation right into the mud, 198% of the cpu | 20:49 |
setuid | bouncing between > 100% and almost 200% CPU | 20:49 |
setuid | 8-core 4Ghz Xeon on a box with 64GB ram | 20:50 |
dhellmann | setuid : tox is just a job running. maybe you mean sphinx? | 20:57 |
dhellmann | or latex? | 20:57 |
dhellmann | *job runner | 20:58 |
*** Aqsa has joined #openstack-doc | 21:02 | |
openstackgerrit | Doug Hellmann proposed openstack/openstack-manuals master: remove the user-guide https://review.openstack.org/482703 | 21:04 |
*** catintheroof has quit IRC | 21:04 | |
openstackgerrit | Doug Hellmann proposed openstack/openstack-manuals master: move config-reference.html to /configuration/ https://review.openstack.org/482589 | 21:06 |
openstackgerrit | Doug Hellmann proposed openstack/openstack-manuals master: move config-reference.html to /configuration/ https://review.openstack.org/482589 | 21:06 |
openstackgerrit | Doug Hellmann proposed openstack/openstack-manuals master: move config-reference.html to /configuration/ https://review.openstack.org/482589 | 21:10 |
openstackgerrit | Doug Hellmann proposed openstack/openstack-manuals master: link to list of api guides from main page https://review.openstack.org/482578 | 21:10 |
setuid | dhellmann: Looks like python2.7, though I'm not surprised, python is a big memory hog | 21:10 |
dhellmann | that's probably sphinx, then | 21:10 |
* setuid goes back to the Great Pyramid and tries to petition for more memory | 21:11 | |
*** rbowen has quit IRC | 21:13 | |
dhellmann | mordred : https://review.openstack.org/482703 | 21:13 |
dhellmann | that's the patch that I had been working on to remove the user guide. | 21:13 |
dhellmann | asettle, AJaeger : we probably want to do a little more due diligence to make sure I'm not deleting user-guide content that is useful ^^ | 21:14 |
*** efried has joined #openstack-doc | 21:19 | |
efried | dhellmann I noticed ceilometer-powervm got flagged in the "list of stuff that we expect to be doing doc migration, but hasn't started" | 21:20 |
dhellmann | efried : yep, gordc already mentioned that it shouldn't be on that list | 21:20 |
efried | dhellmann What's weird to me is that I would have expected nova-powervm and networking-powervm to be in the same boat as ceilometer-powervm - either all three flagged or all three ignored. | 21:20 |
efried | dhellmann What were the criteria used for being flagged? | 21:21 |
dhellmann | it was stuff like has a doc/source directory | 21:21 |
efried | okay; all three of those guys do... | 21:21 |
dhellmann | but I ended up with a bunch of repos that aren't official, or aren't active | 21:21 |
dhellmann | so yeah, please do move the content, but we're mainly focused on tracking the official active repos | 21:21 |
*** dustins has quit IRC | 21:22 | |
efried | dhellmann Okay, so I had been skimming-but-mostly-disregarding the notes flying through on the topic; can you please point me to the overview of what action needs to be taken? | 21:22 |
efried | Sorry about that. | 21:23 |
*** pcaruana has quit IRC | 21:23 | |
dhellmann | efried : sure, there's a spec | 21:23 |
dhellmann | efried : http://specs.openstack.org/openstack/docs-specs/specs/pike/os-manuals-migration.html | 21:23 |
efried | dhellmann Cause I thought the point was to make sure docs were in the doc/source dir of the project they belong to... which those are. | 21:23 |
efried | okay, thank you. | 21:23 |
dhellmann | let me know if you have any questions | 21:23 |
dhellmann | for projects where we're going to link to them from the docs landing pages, we need the content in specific directories | 21:24 |
efried | Gotcha. | 21:24 |
dhellmann | do you publish docs to docs.openstack.org? | 21:24 |
efried | Uhhh | 21:24 |
efried | I know we publish them *somewhere*. | 21:24 |
efried | Lemme find out where... | 21:24 |
dhellmann | they may go to readthedocs.org | 21:24 |
dhellmann | efried : if they're not on docs.openstack.org you don't need to do anything | 21:25 |
efried | dhellmann Looks like it is readthedocs. | 21:28 |
efried | Wohoo, no action necessary! | 21:28 |
dhellmann | the best kind of action! | 21:28 |
*** thorst has joined #openstack-doc | 21:35 | |
*** efried has left #openstack-doc | 21:36 | |
*** thorst has quit IRC | 21:42 | |
*** Aqsa has quit IRC | 21:59 | |
*** edmondsw has quit IRC | 22:26 | |
*** suyog has joined #openstack-doc | 22:32 | |
*** charcol has quit IRC | 22:58 | |
*** tosky has quit IRC | 23:13 | |
*** matjazp has quit IRC | 23:34 | |
*** d0ugal has joined #openstack-doc | 23:36 | |
*** thorst has joined #openstack-doc | 23:47 |
Generated by irclog2html.py 2.15.3 by Marius Gedminas - find it at mg.pov.lt!