| *** jamesmcarthur has quit IRC | 00:14 | |
| *** jamesmcarthur has joined #openstack-doc | 00:15 | |
| *** jamesmcarthur has quit IRC | 00:16 | |
| *** jamesmcarthur has joined #openstack-doc | 00:16 | |
| *** jamesmcarthur has quit IRC | 00:17 | |
| *** jamesmcarthur has joined #openstack-doc | 00:19 | |
| *** jamesmcarthur has quit IRC | 00:19 | |
| *** jamesmcarthur has joined #openstack-doc | 00:35 | |
| *** jamesmcarthur has quit IRC | 00:52 | |
| *** brinzhang has joined #openstack-doc | 01:12 | |
| *** brinzhang_ has quit IRC | 01:15 | |
| *** ianychoi has quit IRC | 01:16 | |
| *** ianychoi has joined #openstack-doc | 01:16 | |
| *** jamesmcarthur has joined #openstack-doc | 01:32 | |
| *** brinzhang_ has joined #openstack-doc | 01:33 | |
| *** brinzhang has quit IRC | 01:36 | |
| *** jamesmcarthur has quit IRC | 01:55 | |
| *** brinzhang has joined #openstack-doc | 02:03 | |
| *** brinzhang_ has quit IRC | 02:06 | |
| *** brinzhang_ has joined #openstack-doc | 02:23 | |
| *** brinzhang has quit IRC | 02:26 | |
| *** jamesmcarthur has joined #openstack-doc | 02:31 | |
| *** ianychoi has quit IRC | 02:31 | |
| *** ianychoi has joined #openstack-doc | 02:33 | |
| *** jamesmcarthur has quit IRC | 02:38 | |
| *** brinzhang has joined #openstack-doc | 02:42 | |
| *** brinzhang_ has quit IRC | 02:45 | |
| *** ianychoi has quit IRC | 02:51 | |
| *** ianychoi has joined #openstack-doc | 02:52 | |
| *** openstackgerrit has joined #openstack-doc | 03:23 | |
| openstackgerrit | caoyuan proposed openstack/openstack-doc-tools master: setup.cfg: Cleanup and update some urls to latest https://review.opendev.org/689646 | 03:23 |
|---|---|---|
| *** brinzhang_ has joined #openstack-doc | 03:36 | |
| *** brinzhang has quit IRC | 03:39 | |
| *** ianychoi has quit IRC | 05:13 | |
| *** ianychoi has joined #openstack-doc | 05:14 | |
| *** ianychoi has quit IRC | 05:26 | |
| *** ianychoi has joined #openstack-doc | 05:28 | |
| *** brinzhang has joined #openstack-doc | 05:39 | |
| *** brinzhang_ has quit IRC | 05:42 | |
| *** miloa has joined #openstack-doc | 06:00 | |
| *** brinzhang_ has joined #openstack-doc | 06:00 | |
| *** brinzhang has quit IRC | 06:04 | |
| openstackgerrit | Qiu Fossen proposed openstack/whereto master: Switch to Ussuri jobs https://review.opendev.org/689956 | 06:05 |
| *** rcernin has quit IRC | 06:16 | |
| *** brinzhang has joined #openstack-doc | 06:34 | |
| *** brinzhang_ has quit IRC | 06:38 | |
| *** pcaruana has joined #openstack-doc | 06:47 | |
| *** brinzhang_ has joined #openstack-doc | 06:48 | |
| *** brinzhang has quit IRC | 06:52 | |
| *** brinzhang_ has quit IRC | 06:53 | |
| *** tosky has joined #openstack-doc | 07:12 | |
| *** jawad_axd has joined #openstack-doc | 07:26 | |
| *** jawad_axd is now known as gchristian | 07:35 | |
| *** jawad_axd has joined #openstack-doc | 07:36 | |
| *** kopecmartin|off is now known as kopecmartin | 08:17 | |
| *** tesseract has joined #openstack-doc | 08:21 | |
| *** tesseract has quit IRC | 08:21 | |
| *** jawad_axd has quit IRC | 08:28 | |
| *** andyzon has joined #openstack-doc | 08:29 | |
| *** alexmcleod has joined #openstack-doc | 08:32 | |
| *** pcaruana has quit IRC | 10:16 | |
| *** pcaruana has joined #openstack-doc | 10:21 | |
| openstackgerrit | Merged openstack/whereto master: Switch to Ussuri jobs https://review.opendev.org/689024 | 10:22 |
| openstackgerrit | Merged openstack/openstack-doc-tools master: Switch to ussuri python3 jobs https://review.opendev.org/689023 | 10:29 |
| *** tonyb has joined #openstack-doc | 11:31 | |
| *** ianychoi has quit IRC | 11:37 | |
| *** ianychoi has joined #openstack-doc | 11:40 | |
| *** ianychoi has quit IRC | 12:00 | |
| *** ianychoi has joined #openstack-doc | 12:03 | |
| *** jamesmcarthur has joined #openstack-doc | 12:18 | |
| *** jamesmcarthur has quit IRC | 12:30 | |
| *** ianychoi has quit IRC | 12:39 | |
| *** ianychoi has joined #openstack-doc | 12:41 | |
| *** ianychoi has quit IRC | 12:54 | |
| *** ianychoi has joined #openstack-doc | 12:57 | |
| *** efried has joined #openstack-doc | 13:04 | |
| efried | o/ docs | 13:05 |
| efried | asettle: trying to make :doc:`foo` work, is that something you could help with? | 13:05 |
| asettle | Helloooo | 13:07 |
| efried | Hi :) | 13:07 |
| asettle | In theory ;) yep | 13:07 |
| asettle | Have you got a review up or are you doing this locally now? | 13:07 |
| efried | locally for now. I thought having openstackdocstheme in my extensions and foo in my openstack_projects in doc/source/conf.py was the magic sauce. | 13:08 |
| efried | I can post if it will help... | 13:08 |
| asettle | Might be helpful indeed, yes. It's been a while since I had to do this off the top of my head | 13:08 |
| asettle | Sorry | 13:08 |
| efried | asettle: https://review.opendev.org/690071 | 13:09 |
| * asettle goes to look | 13:10 | |
| efried | The docs build fails with: | 13:10 |
| efried | Warning, treated as error: | 13:10 |
| efried | /home/efried/openstack/python-openstackclient/doc/source/cli/plugin-commands/aodh.rst:4:unknown document: aodhclient | 13:10 |
| efried | ERROR: InvocationError for command /home/efried/openstack/python-openstackclient/.tox/docs/bin/sphinx-build -a -E -W -d doc/build/doctrees -b html doc/source doc/build/html (exited with code 2) | 13:10 |
| * asettle pulls it down | 13:10 | |
| asettle | Let me take a look | 13:10 |
| efried | I was modeling this after what I see in nova's doc/source/conf.py -- we ref a bunch of other projects from there in our docs. | 13:10 |
| asettle | Yah makes sense | 13:10 |
| efried | d'oh, I think possibly I know what I did wrong... | 13:12 |
| asettle | Oh that was fast, cause it's taking me ages to update my repos here | 13:12 |
| efried | those bits gotta fly all the way around the world for you | 13:12 |
| asettle | Tell me about it. THen through the house, and out the yard, into my office/shed | 13:13 |
| efried | Metal shed? | 13:13 |
| asettle | Wooden, I'm afraid. | 13:13 |
| efried | With little bits of paper pasted all over it? A Beautiful Mind style? | 13:13 |
| efried | Okay, yeah, I got it. | 13:14 |
| asettle | In my dreams. I think my "co-worker" might have something to say about that. Although he seems cool with the weird mess on the floor I've created with the books | 13:14 |
| efried | asettle: I forgot that I should be using :foo-doc:`/path/to/doc` instead of :doc:`foo </path/to/doc>` | 13:14 |
| efried | I always f that up. | 13:14 |
| efried | Thanks for the help! (Yes, you did help :) | 13:15 |
| asettle | Oh yah, of course | 13:15 |
| asettle | You did good here | 13:15 |
| asettle | I'm glad that my exciting conversation spurred you on | 13:15 |
| *** ianychoi has quit IRC | 13:58 | |
| *** ianychoi has joined #openstack-doc | 14:00 | |
| *** andyzon has quit IRC | 14:19 | |
| *** andyzon has joined #openstack-doc | 14:20 | |
| *** andyzon has quit IRC | 14:25 | |
| *** andyzon has joined #openstack-doc | 14:33 | |
| *** ianychoi has quit IRC | 14:38 | |
| *** ianychoi has joined #openstack-doc | 14:40 | |
| efried | asettle: still around? | 14:46 |
| asettle | I never leave | 14:46 |
| efried | heh | 14:46 |
| efried | so I have a .rst file that's like five lines long: | 14:46 |
| efried | e.g. | 14:47 |
| efried | octavia | 14:47 |
| efried | ------- | 14:47 |
| efried | .. autoprogram-cliff:: openstack.load_balancer.v2 | 14:47 |
| efried | But when I build, I get an error like: | 14:47 |
| efried | /home/efried/openstack/python-openstackclient/doc/source/cli/plugin-commands/octavia.rst:60:Inline literal start-string without end-string. | 14:47 |
| efried | clearly there's some meta-doc being built out of this that actually *has* 60 lines... | 14:48 |
| efried | but I can't find it anywhere in the build tree | 14:48 |
| efried | I'm doing that ^ from within the python-openstackclient project. When I do the same thing from within the python-octaviaclient project itself, it builds fine. | 14:49 |
| efried | Both are using sphinx-build -W | 14:49 |
| asettle | huh | 14:49 |
| asettle | Give me a bit, I'm on a meeting currently but it should end soon | 14:49 |
| efried | nod. Not super urgent (clearly, these docs have been broken for multiple releases) | 14:49 |
| *** jamesmcarthur has joined #openstack-doc | 14:53 | |
| *** pcaruana has quit IRC | 14:58 | |
| *** andyzon has quit IRC | 15:50 | |
| *** ianychoi has quit IRC | 15:52 | |
| *** ianychoi has joined #openstack-doc | 15:54 | |
| johnsom | efried There is some magic in the cliff stuff and how python-openstackclient gets the plugin info that I don't all remember. Have you tried adding "-v" to the sphinx build to maybe get more details on where the "octavia.rst" would be? | 16:08 |
| efried | oo, will try johnsom, thanks | 16:09 |
| johnsom | Let me know if I can help. I'm not even sure how to reproduce that. Just tox -e docs in python-openstackclient? | 16:10 |
| efried | johnsom: fyi this pile makes a number of improvements to the osc docs for the plugins (including octavia) https://review.opendev.org/#/q/owner:"Eric+Fried+%253Copenstack%2540fried.cc%253E"+project:openstack/python-openstackclient | 16:10 |
| johnsom | Cool, thank you! | 16:11 |
| efried | johnsom: to repro, you would have to take the top of that series and flip list-plugins to autopackage-cliff in octavia.rst | 16:11 |
| efried | johnsom: sorry, autoprogram-cliff | 16:22 |
| johnsom | Yeah, I got it, repro'd, looking into it now | 16:22 |
| efried | cool, thanks! | 16:22 |
| pmatulis | i heard about PDF format for documentation. is that right? if so, how will it work? | 16:38 |
| asettle | Sorry efried the afternoon got completely away from me | 16:38 |
| asettle | Are you still experiencing the same issue? | 16:39 |
| asettle | pmatulis, sure is | 16:39 |
| asettle | You can build PDFs locally using tox -e pdf-docs :) | 16:39 |
| johnsom | pmatulis https://etherpad.openstack.org/p/train-pdf-support-goal | 16:39 |
| johnsom | asettle I have not resolved the issue yet | 16:39 |
| pmatulis | ohh | 16:39 |
| *** miloa has quit IRC | 16:39 | |
| asettle | You're looking at it now johnsom ? | 16:39 |
| asettle | Sorry I should read backlog first | 16:39 |
| johnsom | I was trying to help out | 16:40 |
| asettle | You're nice :) | 16:40 |
| johnsom | lol | 16:41 |
| *** pcaruana has joined #openstack-doc | 16:41 | |
| *** alexmcleod has quit IRC | 16:41 | |
| *** pcaruana has quit IRC | 16:52 | |
| efried | asettle: been in meetings too. johnsom saw "octavia" and thought he should lend a hand :P | 17:01 |
| efried | johnsom: any progress before I jump back in? | 17:01 |
| johnsom | Nope | 17:02 |
| efried | -v didn't reveal anything useful? | 17:02 |
| *** kopecmartin is now known as kopecmartin|off | 17:08 | |
| efried | I can't make heads or tails of these doctree files. | 17:25 |
| johnsom | Yeah, I'm not getting anywhere either. I tried the -> xml -> rst but the code is old and broken it appears | 17:25 |
| johnsom | I added -v -v -v, but still didn't get enough info. Maybe I needed more | 17:26 |
| efried | johnsom: Yeah, with three vs, I get lots of output, and I see stuff around where the error happens, but so far no revelations. | 17:29 |
| efried | I'm bisecting the entry points and have narrowed it down! | 17:33 |
| efried | I should figure out how to speed up the build... | 17:34 |
| *** ianychoi has quit IRC | 17:39 | |
| johnsom | Well, hmmm, I can get it to fail with limiting it to the "loadbalancer pool create" command | 17:42 |
| efried | johnsom: exactly. | 17:42 |
| efried | And I found the problem. | 17:42 |
| efried | stand by | 17:42 |
| johnsom | Score! | 17:42 |
| *** ianychoi has joined #openstack-doc | 17:42 | |
| johnsom | Absolutely zero idea why it doesn't fail on our docs run for that command.... | 17:43 |
| efried | Because you're building master. | 17:43 |
| efried | https://opendev.org/openstack/python-octaviaclient/src/tag/1.10.0/octaviaclient/osc/v2/pool.py#L96 | 17:43 |
| efried | see the `` followed immediately by " meaning the literal runs into the next line? | 17:44 |
| efried | Master doesn't have that, but 1.10.0 does. | 17:44 |
| efried | So | 17:44 |
| johnsom | Ah | 17:44 |
| efried | Release a new python-octaviaclient, and we can bump the minimum in osc and we're good. | 17:44 |
| johnsom | I fixed that for the PDF docs.... | 17:45 |
| efried | https://opendev.org/openstack/python-octaviaclient/commit/ba03fed2959406d0a82afeeaa1dc201770f4a3fd yup | 17:45 |
| efried | Now that I know what I'm looking for, it should be way easier to nail down for the other projects that are failing similarly. | 17:46 |
| *** andyzon has joined #openstack-doc | 17:46 | |
| johnsom | Yeah. Thanks for finding that! I'm going to work on that release. | 17:46 |
| *** ianychoi has quit IRC | 17:55 | |
| pmatulis | question. all my internal links end up italicised. is there any way to avoid that? | 17:58 |
| *** ianychoi has joined #openstack-doc | 17:58 | |
| pmatulis | :ref:`Some title <some_anchor>` | 18:00 |
| AJaeger | pmatulis: push a review and show us what fails, please | 18:00 |
| AJaeger | pmatulis: I don't see this here: https://docs.openstack.org/doc-contrib-guide/rst-conv/references.html | 18:01 |
| *** jamesmcarthur has quit IRC | 18:01 | |
| pmatulis | AJaeger, i haven't seen that doc. lemme look it over | 18:01 |
| AJaeger | pmatulis: I just linked to it to show that it's not italic for me ;) It shows code and it's usage | 18:02 |
| pmatulis | AJaeger, yeah, no change. the only difference is that the target is on another page | 18:08 |
| AJaeger | pmatulis: could you push the review up so that I can check myself? | 18:10 |
| *** ianychoi has quit IRC | 18:12 | |
| *** ianychoi has joined #openstack-doc | 18:16 | |
| AJaeger | pmatulis: "Running Sphinx v1.2.3" - why such an ancient version? | 18:23 |
| AJaeger | pmatulis: upgrade the jobs to modern sphinx and openstackdocstheme versions, please and try again... | 18:23 |
| *** ianychoi has quit IRC | 18:26 | |
| *** ianychoi has joined #openstack-doc | 18:30 | |
| pmatulis | AJaeger, where do you see that again? | 18:31 |
| AJaeger | pmatulis: in the logs ;) | 18:33 |
| AJaeger | go to your review and click on the job to get the log file | 18:34 |
| AJaeger | that will guide you to https://zuul.opendev.org/t/openstack/build/e6452eb117364339b52b8b1a1c0949bb | 18:34 |
| AJaeger | click on "Consoloe" | 18:34 |
| AJaeger | click on "Console" | 18:34 |
| AJaeger | and check output of "tox: Run tox" - that's where the work happens | 18:34 |
| AJaeger | pmatulis: I'm not sure whether it will fix that problem - but that's what you should do anyhow first. | 18:35 |
| AJaeger | We're on Sphinx 2 since some time and nobody will help you with an older version | 18:35 |
| AJaeger | Sorry, have to leave now... | 18:36 |
| pmatulis | AJaeger, thx for the pointers | 18:36 |
| *** ianychoi has quit IRC | 18:38 | |
| *** ianychoi has joined #openstack-doc | 18:42 | |
| *** jamesmcarthur has joined #openstack-doc | 18:47 | |
| *** jamesmcarthur_ has joined #openstack-doc | 18:50 | |
| *** jamesmcarthur has quit IRC | 18:54 | |
| *** andyzon has quit IRC | 19:00 | |
| *** pcaruana has joined #openstack-doc | 19:04 | |
| *** ianychoi has quit IRC | 19:04 | |
| *** jamesmcarthur has joined #openstack-doc | 19:05 | |
| *** jamesmca_ has joined #openstack-doc | 19:06 | |
| *** ianychoi has joined #openstack-doc | 19:08 | |
| *** jamesmcarthur_ has quit IRC | 19:08 | |
| *** jamesmcarthur has quit IRC | 19:09 | |
| *** jamesmcarthur has joined #openstack-doc | 19:10 | |
| *** jamesmcarthur has quit IRC | 19:12 | |
| *** jamesmca_ has quit IRC | 19:13 | |
| *** jamesmcarthur has joined #openstack-doc | 19:15 | |
| *** ianychoi has quit IRC | 19:15 | |
| *** pcaruana has quit IRC | 19:19 | |
| *** ianychoi has joined #openstack-doc | 19:24 | |
| *** jamesmcarthur has quit IRC | 19:27 | |
| *** jamesmcarthur has joined #openstack-doc | 19:32 | |
| *** ianychoi has quit IRC | 19:39 | |
| *** jamesmcarthur has quit IRC | 19:46 | |
| *** tosky has quit IRC | 22:56 | |
| pmatulis | i'm looking over the contributor guide and i only see up to 3 heading styles defined. what do people use for H4? | 23:51 |
| pmatulis | https://docs.openstack.org/doc-contrib-guide/rst-conv/titles.html#cg-titles | 23:51 |
Generated by irclog2html.py 2.15.3 by Marius Gedminas - find it at mg.pov.lt!