| *** brinzhang has joined #openstack-doc | 00:56 | |
| *** altlogbot_1 has quit IRC | 03:16 | |
| *** altlogbot_0 has joined #openstack-doc | 03:17 | |
| *** brinzhang has quit IRC | 03:21 | |
| *** brinzhang has joined #openstack-doc | 03:22 | |
| openstackgerrit | Andreas Jaeger proposed openstack/openstack-doc-tools master: Publish to publish-docs/html https://review.opendev.org/676572 | 04:25 |
|---|---|---|
| openstackgerrit | Andreas Jaeger proposed openstack/openstack-doc-tools master: Publish to publish-docs/html https://review.opendev.org/676572 | 04:30 |
| openstackgerrit | Andreas Jaeger proposed openstack/security-doc master: Use publish-docs/html https://review.opendev.org/676574 | 04:36 |
| *** brinzhang has quit IRC | 04:38 | |
| openstackgerrit | Andreas Jaeger proposed openstack/api-site master: Switch publishing to publish-docs/html https://review.opendev.org/676575 | 04:38 |
| *** brinzhang has joined #openstack-doc | 04:39 | |
| *** brinzhang has quit IRC | 04:44 | |
| *** brinzhang has joined #openstack-doc | 04:45 | |
| openstackgerrit | Andreas Jaeger proposed openstack/api-site master: Switch publishing to publish-docs/html https://review.opendev.org/676575 | 04:45 |
| openstackgerrit | Andreas Jaeger proposed openstack/training-guides master: Publish to publish-docs/html https://review.opendev.org/676576 | 04:45 |
| openstackgerrit | Andreas Jaeger proposed openstack/security-doc master: Use publish-docs/html https://review.opendev.org/676574 | 04:46 |
| openstackgerrit | Andreas Jaeger proposed openstack/openstack-manuals master: Switch output to publish-docs/html https://review.opendev.org/676482 | 04:47 |
| openstackgerrit | Andreas Jaeger proposed openstack/openstack-manuals master: Use opendev-tox-docs job https://review.opendev.org/676483 | 04:47 |
| openstackgerrit | Andreas Jaeger proposed openstack/security-doc master: Use publish-docs/html https://review.opendev.org/676574 | 04:49 |
| *** brinzhang has quit IRC | 04:55 | |
| *** brinzhang has joined #openstack-doc | 04:55 | |
| *** brinzhang has quit IRC | 04:56 | |
| openstackgerrit | Andreas Jaeger proposed openstack/openstack-manuals master: Use opendev-tox-docs job https://review.opendev.org/676483 | 05:01 |
| openstackgerrit | Andreas Jaeger proposed openstack/security-doc master: Use publish-docs/html https://review.opendev.org/676574 | 05:01 |
| AJaeger | stephenfin, ianychoi, asettle, we'd like to change publishing location to publish-docs/html. Could you review changes, please? I'll +A myself everything in the right order and test. This will allow us to publish *directly* to the website the content from the gate jobs without rerunning the jobs in post queue. | 05:22 |
| *** brinzhang has joined #openstack-doc | 05:45 | |
| *** kopecmartin|off is now known as kopecmartin | 07:16 | |
| *** jawad_axd has joined #openstack-doc | 07:26 | |
| *** alexmcleod has joined #openstack-doc | 08:40 | |
| frickler | can someone tell me the new location of the user-guide? keystone docs link to https://docs.openstack.org/user-guide/common/cli-set-environment-variables-using-openstack-rc.html#download-and-source-the-openstack-rc-file but that redirect to the not very helpful https://docs.openstack.org/stein/user/#download-and-source-the-openstack-rc-file | 09:25 |
| frickler | probably will use https://docs.openstack.org/python-openstackclient/stein/configuration/index.html as best match I found | 09:29 |
| *** jawad_axd has quit IRC | 09:29 | |
| AJaeger | frickler: it was moved in-tree... | 09:29 |
| AJaeger | regarding the location you have: I don't know where this ended, python-openstackclient might be it. | 09:30 |
| frickler | is there a way to create a link to a different project that will automatically match the branch? i.e. link to latest when rendered in master and link to stein when rendered in stable/stein ? | 09:30 |
| AJaeger | frickler: yes, let me find a link... | 09:31 |
| AJaeger | https://docs.openstack.org/openstackdocstheme/latest/#external-link-helper | 09:31 |
| frickler | AJaeger: awesome, thanks a lot | 09:32 |
| *** pkovar has joined #openstack-doc | 09:44 | |
| stephenfin | asettle: So for the PDF goal, I've been slowly working on adding Python 3 support to rst2pdf, since I think that should provide a pure Python way to generate PDFs. However, I haven't gone so far as to check if the output with Python 2 is actually what we want | 09:48 |
| stephenfin | asettle: I wonder if it would be worth sitting down and playing with it on a larger project like neutron to see how much it can do. Apparently they have decent styling capabilities but I haven't checked them out yet | 09:49 |
| stephenfin | asettle: I can do it myself, but realistically that's not going to happen until after M3 given the amount of stuff I have in-flight both upstream and downstream /o\ | 09:49 |
| asettle | stephenfin, gracaias | 09:50 |
| asettle | ... gracias*? | 09:50 |
| stephenfin | asettle: I think this guide should cover how to do it. Remember though: you've got to use Python 2 atm https://gist.github.com/alfredodeza/7fb5c667addb1c6963b9 | 09:50 |
| stephenfin | I'll keep working on Python 3 support in the background. Hopefully the rst2pdf is receptive | 09:51 |
| AJaeger | asettle, stephenfin , good morning - did you see my changes for changing publish-docs to publish-docs/html? See https://review.opendev.org/#/q/status:open+++topic:promote-openstack-manuals . I'm happy to self-approve later to untangle this and test that it all works. IT would really simplify CI jobs... | 09:54 |
| asettle | No worries. Yes, stephenfin made me aware of them. Reviewing now. | 09:54 |
| AJaeger | thanks | 09:55 |
| *** pkovar has quit IRC | 11:02 | |
| *** pkovar has joined #openstack-doc | 11:16 | |
| *** dmacpher has joined #openstack-doc | 11:38 | |
| *** pkovar has quit IRC | 12:54 | |
| *** pkovar has joined #openstack-doc | 12:55 | |
| asettle | AJaeger, where is the projects.yaml file currently? I cannot see jenkins/jobs in https://opendev.org/openstack/project-config | 13:55 |
| asettle | Looking for the deploy-guide-jobs | 13:56 |
| asettle | FOUND IT | 13:57 |
| asettle | No I didnt | 13:57 |
| AJaeger | https://opendev.org/openstack/openstack-zuul-jobs/src/branch/master/zuul.d/jobs.yaml#L673 | 14:05 |
| AJaeger | asettle: ^ | 14:05 |
| AJaeger | asettle: why are you looking for that? Anything else you need? | 14:06 |
| asettle | Interestingly, I got an email. I was looking to help him with the deploy stuff and setup the kolla docs properly. He pointed out that the TripleO docs... aren't quite the same | 14:06 |
| asettle | https://docs.openstack.org/stein/deploy/ | 14:07 |
| asettle | When you hit up the TripleO "Deployment Guide" even the link is different, and it takes you to their home page | 14:07 |
| asettle | Whereas the others all have "https://docs.openstack.org/project-deploy-guide/.../.../" | 14:07 |
| AJaeger | asettle: that is configured in openstack-manuals/www | 14:07 |
| AJaeger | www/project-data/stein.yaml is the exact file | 14:08 |
| asettle | Yes, sorry, so the reason I asked for the project.yaml is because our instructions: https://docs.openstack.org/doc-contrib-guide/project-deploy-guide.html | 14:08 |
| asettle | For the infra stuff | 14:08 |
| asettle | Isn't quite right naymore | 14:08 |
| AJaeger | tripleo-docs is the odd one here ;) | 14:08 |
| asettle | So, what I can't figure out is how they have a deployment guide up when: https://github.com/openstack/openstack-manuals/blob/master/www/project-data/stein.yaml#L815 | 14:09 |
| AJaeger | asettle: www/stein/deploy/index.html has triploe-docs hardcoded ;( | 14:11 |
| asettle | FML how'd that happen | 14:12 |
| asettle | Can I change, AJaeger ? Probs should ask tripleo first, but it is not a landing page for deployment project docs | 14:15 |
| AJaeger | asettle: sure, discuss with tripleo and change ;) | 14:16 |
| * asettle goes to do the thing | 14:17 | |
| AJaeger | ;) | 14:23 |
| AJaeger | thanks | 14:23 |
| amotoki | stephenfin: FYI: I can generate PDF for nova doc with a small change when I exclude doc/source/configuration/sample-config.rst from the index | 15:03 |
| amotoki | The change I made is like http://paste.openstack.org/show/757336/ | 15:03 |
| amotoki | sample-config.rst looks too large for LaTeX. An error I got is "TeX capacity exceeded: ....". It is different from neutron case but it looks similar problem. | 15:05 |
| amotoki | Anyway it would be great if you can overcome these issues with rst2pdf | 15:05 |
| *** hemna has joined #openstack-doc | 15:11 | |
| stephenfin | amotoki: Oh really? | 15:22 |
| stephenfin | I had no idea where to even start with that | 15:22 |
| stephenfin | I thought our documentation tree in general was too bit | 15:22 |
| stephenfin | *big | 15:22 |
| stephenfin | There was also some issue with recursion that I was seeing | 15:22 |
| hemna | so it looks like you guys are trying to gen the pdfs as part of the openstack-tox-docs jobs | 15:32 |
| asettle | Uhhh | 15:33 |
| asettle | Yeah | 15:33 |
| asettle | :D | 15:33 |
| asettle | hemna, I actually just had to do a "whois" | 15:33 |
| asettle | stephenfin, this is hemna - cinder core. Hopefully he can help us with the gens | 15:34 |
| hemna | so, should I put up a bogus cinder patch and make it dep on https://review.opendev.org/#/c/664555/ to see if it works for cinder? | 15:34 |
| asettle | A dep? | 15:35 |
| stephenfin | hemna: that should work, though I'd personally just been doing it locally (quicker turn around). I doubt it will build first time | 15:35 |
| stephenfin | asettle: A 'Depends-On' tag | 15:35 |
| asettle | Oh aye | 15:36 |
| hemna | https://review.opendev.org/#/c/676721/ | 15:40 |
| hemna | guess I'll have to do that for the rest of Cinder's repos as well | 15:41 |
| hemna | os-brick, cinderlib, cinderclient, etc | 15:41 |
| hemna | stephenfin: how do you run the local test ? | 15:41 |
| stephenfin | hemna: Assuming you have an Ubuntu host available, install the bindeps and run the script from https://review.opendev.org/#/c/664555/2/roles/build-pdf-docs/tasks/main.yaml | 15:42 |
| hemna | heh crap. step 1.... I'm on Leap 15.1 | 15:42 |
| stephenfin | then the bindeps will be slightly different but not much | 15:45 |
| stephenfin | I got it to run on Fedora 28 without issue. I assume most of the RPMs are the same | 15:46 |
| *** kopecmartin is now known as kopecmartin|off | 16:09 | |
| *** alexmcleod has quit IRC | 16:33 | |
| AJaeger | stephenfin: I'll self-approve https://review.opendev.org/676482 to move us forward with that change in a bit unless you cry loudly ;) | 16:36 |
| amotoki | stephenfin: I pushed a WIP patch to nova PDF doc build. https://review.opendev.org/#/c/676730/ It works locally. See the commit message for detail I did. | 16:39 |
| *** pkovar has quit IRC | 16:54 | |
| AJaeger | stephenfin: I need you to +1 the release of openstack-doc-tools 2.0.0, see https://review.opendev.org/676739 - but first we need to merge change https://review.opendev.org/676572 and test that everything works. I'm on it... | 17:20 |
| AJaeger | So, +1 anytime, please ;) | 17:20 |
| openstackgerrit | Merged openstack/openstack-manuals master: Switch output to publish-docs/html https://review.opendev.org/676482 | 17:26 |
| AJaeger | so, first change is green - now the next ones ;) | 18:13 |
| openstackgerrit | Merged openstack/openstack-doc-tools master: Publish to publish-docs/html https://review.opendev.org/676572 | 18:25 |
| openstackgerrit | Andreas Jaeger proposed openstack/openstack-manuals master: DNM - testing publishbuild https://review.opendev.org/676750 | 18:25 |
| openstackgerrit | Andreas Jaeger proposed openstack/openstack-doc-tools master: Cleanup doc-tools-check-languages https://review.opendev.org/676751 | 18:36 |
| openstackgerrit | Andreas Jaeger proposed openstack/openstack-manuals master: Use opendev-tox-docs job https://review.opendev.org/676483 | 18:52 |
| openstackgerrit | Andreas Jaeger proposed openstack/openstack-manuals master: Use opendev-tox-docs job https://review.opendev.org/676483 | 18:55 |
| openstackgerrit | Andreas Jaeger proposed openstack/openstack-manuals master: Use opendev-tox-docs job https://review.opendev.org/676483 | 19:04 |
| openstackgerrit | Andreas Jaeger proposed openstack/openstack-manuals master: Use opendev-tox-docs job https://review.opendev.org/676483 | 19:20 |
| hemna | 2019-08-15 15:52:59.527283 | TASK [build-pdf-docs : Install PDF prereqs] | 19:23 |
| hemna | 2019-08-15 15:53:00.223373 | ubuntu-bionic | MODULE FAILURE: sudo: a password is requiredy | 19:23 |
| hemna | got that in my cinder patch | 19:23 |
| AJaeger | hemna: yes, that role does not work as is - that's why it has a -1 ;) | 19:24 |
| AJaeger | you need to do the same as amotoki is doing in neutron and copy in the script | 19:25 |
| *** vesper11 has quit IRC | 19:30 | |
| hemna | build succeeded. | 19:34 |
| hemna | The LaTeX files are in doc/build/pdf. | 19:34 |
| hemna | :) | 19:34 |
| hemna | did that locally | 19:34 |
| hemna | seems happy | 19:34 |
| hemna | http://paste.openstack.org/show/757496/ | 19:39 |
| hemna | make has lots of output | 19:40 |
| openstackgerrit | Andreas Jaeger proposed openstack/openstack-manuals master: Use opendev-tox-docs job https://review.opendev.org/676483 | 19:46 |
| AJaeger | asettle, stephenfin, let's build the same content in check that we publish, I think this is fine nowadays. Please review ^ | 19:46 |
| hemna | the pdf got build anyway | 19:50 |
| hemna | even though make puked out lots of errors | 19:50 |
| *** hemna has quit IRC | 20:24 | |
| *** vesper11 has joined #openstack-doc | 20:51 | |
| *** goldyfruit has quit IRC | 22:35 | |
| *** goldyfruit has joined #openstack-doc | 22:38 | |
| *** goldyfruit has quit IRC | 22:56 | |
| *** goldyfruit has joined #openstack-doc | 22:56 | |
Generated by irclog2html.py 2.15.3 by Marius Gedminas - find it at mg.pov.lt!