| *** jamesmcarthur has quit IRC | 00:03 | |
| *** eumel8 has quit IRC | 01:24 | |
| *** jamesmcarthur has joined #openstack-doc | 02:21 | |
| *** jamesmcarthur has quit IRC | 03:30 | |
| *** jamesmcarthur has joined #openstack-doc | 04:22 | |
| *** jamesmcarthur has quit IRC | 04:26 | |
| *** kopecmartin has joined #openstack-doc | 05:31 | |
| *** nicolasbock has joined #openstack-doc | 05:34 | |
| *** eumel8 has joined #openstack-doc | 05:36 | |
| *** pkovar has joined #openstack-doc | 05:59 | |
| *** AJaeger has quit IRC | 06:16 | |
| *** AJaeger has joined #openstack-doc | 06:19 | |
| *** nicolasbock has quit IRC | 06:35 | |
| *** pcaruana has joined #openstack-doc | 06:38 | |
| *** nicolasbock has joined #openstack-doc | 06:41 | |
| *** evrardjp has joined #openstack-doc | 06:54 | |
| *** masakif has joined #openstack-doc | 06:59 | |
| *** masakif is now known as masakif_ | 07:00 | |
| *** masakif_ is now known as masakif__ | 07:00 | |
| *** masakif__ is now known as masakif | 07:00 | |
| *** masakif has quit IRC | 07:00 | |
| *** masakif has joined #openstack-doc | 07:01 | |
| *** rcernin has quit IRC | 07:16 | |
| openstackgerrit | OpenStack Proposal Bot proposed openstack/api-site master: Imported Translations from Zanata https://review.openstack.org/590161 | 07:36 |
|---|---|---|
| openstackgerrit | OpenStack Proposal Bot proposed openstack/openstack-manuals master: Imported Translations from Zanata https://review.openstack.org/590166 | 07:38 |
| openstackgerrit | OpenStack Proposal Bot proposed openstack/training-guides master: Imported Translations from Zanata https://review.openstack.org/590172 | 07:43 |
| openstackgerrit | OpenStack Proposal Bot proposed openstack/security-doc master: Imported Translations from Zanata https://review.openstack.org/590176 | 07:49 |
| *** tosky has joined #openstack-doc | 07:52 | |
| openstackgerrit | Merged openstack/api-site master: Imported Translations from Zanata https://review.openstack.org/590161 | 08:04 |
| ianychoi | AJaeger, dhellmann - thanks a lot for kind comments and I would like to select one project and implement as a prototype :) | 08:04 |
| openstackgerrit | Merged openstack/openstack-manuals master: Imported Translations from Zanata https://review.openstack.org/590166 | 08:05 |
| openstackgerrit | Merged openstack/training-guides master: Imported Translations from Zanata https://review.openstack.org/590172 | 08:06 |
| *** KeithMnemonic has quit IRC | 08:23 | |
| *** dtantsur|afk is now known as dtantsur | 08:33 | |
| *** masakif has quit IRC | 09:04 | |
| openstackgerrit | Merged openstack/security-doc master: Imported Translations from Zanata https://review.openstack.org/590176 | 09:41 |
| *** pkovar has quit IRC | 09:56 | |
| *** pkovar has joined #openstack-doc | 11:04 | |
| *** snapiri has quit IRC | 11:25 | |
| *** snapiri has joined #openstack-doc | 11:25 | |
| *** jamesmcarthur has joined #openstack-doc | 12:23 | |
| *** jamesmcarthur has quit IRC | 12:27 | |
| scas | good day. i've pieced together some initial documentation for chef openstack, which included shuffling repos to remove the '-repo' name from the entry point. at what point can i consider things good to make the switch to publish? | 12:29 |
| AJaeger | scas: any time you want ;) | 12:30 |
| AJaeger | scas: once your repo is in governance repo listed as official | 12:31 |
| scas | ah. still unmerged | 12:31 |
| scas | okay | 12:32 |
| AJaeger | scas: second step is then to list it in the index files that we host in openstack-manuals repository. You could do that later... | 12:32 |
| AJaeger | So, publish what you have, and once you're happy (better: your team is), then add to index file. | 12:32 |
| scas | ...team :) | 12:32 |
| scas | i digress, but that makes sense | 12:33 |
| AJaeger | scas: push a change to project-config that links to the governance change. I would merge it even without waiting for governance change to merge as long as I can check that it exists ;) | 12:34 |
| scas | i have to see what all has been merged. the governance change is outstanding from the repo shuffle | 12:35 |
| scas | everything is in-repo at this point, including the doc build job. i should be able to make the switch there, no? | 12:37 |
| scas | i've been combing over everything for the branches that do have docs. they *should* be in a place to publish at this point, but i've little confidence in something that hasn't had a weathered eye | 12:39 |
| scas | i'm not disparaging anyone but myself, and i don't mind being called out :) | 12:41 |
| AJaeger | scas: yes, do it in-repo | 12:41 |
| AJaeger | scas: go ahead and just do it. | 12:41 |
| AJaeger | scas: I'm happy to review your change and +1, just tell me... | 12:42 |
| scas | that'll work for me. self-review is always biased | 12:42 |
| *** oanson has joined #openstack-doc | 12:42 | |
| *** tpsilva has joined #openstack-doc | 12:44 | |
| *** edmondsw has joined #openstack-doc | 12:45 | |
| *** ianychoi has quit IRC | 12:49 | |
| *** jamesmcarthur has joined #openstack-doc | 13:02 | |
| scas | like i said, everything but the governance change has been merged at this point. all the rst data appears to be building both locally and by way of zuul. https://review.openstack.org/590307 exists for master and https://review.openstack.org/590308 for stable/queens | 13:10 |
| *** dustins has joined #openstack-doc | 13:17 | |
| *** edmondsw has quit IRC | 13:29 | |
| *** edmondsw has joined #openstack-doc | 13:37 | |
| *** edmondsw has quit IRC | 13:41 | |
| *** edmondsw has joined #openstack-doc | 13:48 | |
| openstackgerrit | Petr Kovar proposed openstack/openstack-manuals master: [WIP] Add www pages for Stein https://review.openstack.org/590333 | 13:51 |
| pkovar | cores: looks like too many projects haven't yet branched for rocky, hence the wip status ^^ | 14:00 |
| *** amotoki_ is now known as amotoki | 14:01 | |
| kopecmartin | pkovar, hi | 14:02 |
| pkovar | hello kopecmartin | 14:02 |
| kopecmartin | pkovar, it seems this patch https://review.openstack.org/#/c/585198/ | 14:02 |
| kopecmartin | caused a bug, but it's a quick fix | 14:02 |
| kopecmartin | the color is too bright now :/ https://docs.openstack.org/infra/manual/zuulv3.html#how-jobs-are-selected-to-run-in-zuul-v3 | 14:03 |
| kopecmartin | I've created a bug for that too https://bugs.launchpad.net/openstack-doc-tools/+bug/1785994 | 14:03 |
| openstack | Launchpad bug 1785994 in openstack-doc-tools "Too bright highlight color" [Undecided,New] | 14:03 |
| pkovar | kopecmartin: thanks | 14:08 |
| pkovar | chason: fyi, looks like we need more css tweaking in openstackdocstheme ^^ | 14:08 |
| pkovar | kopecmartin: let me try a quick fix | 14:12 |
| kopecmartin | pkovar, thanks | 14:13 |
| pkovar | though i am pretty color blind :) | 14:13 |
| pkovar | but we can iterate | 14:13 |
| pkovar | and we will need a new release of the theme package | 14:14 |
| *** KeithMnemonic has joined #openstack-doc | 14:19 | |
| openstackgerrit | Petr Kovar proposed openstack/openstackdocstheme master: Make bg color for highlighted text less bright https://review.openstack.org/590345 | 14:21 |
| pkovar | kopecmartin: ^ | 14:22 |
| kopecmartin | pkovar, looks much better, thanks | 14:26 |
| pkovar | thanks for the heads up, kopecmartin | 14:26 |
| *** dtantsur is now known as dtantsur|brb | 14:43 | |
| *** dtantsur|brb is now known as dtantsur | 15:29 | |
| aspiers | any Sphinx experts around? I'm wondering how to avoid "WARNING: document isn't included in any toctree" | 15:41 |
| aspiers | https://github.com/openstack/self-healing-sig/compare/master...aspiers:reorg#diff-4bc0dbe7e164d778c3dc17f70c9f15ac | 15:41 |
| AJaeger | aspiers: add it to an index file ;) | 15:44 |
| aspiers | also, why do I get this same error 4 times from "tox -e docs"? | 15:44 |
| aspiers | AJaeger: duh, I already did that :) | 15:44 |
| aspiers | AJaeger: I'm not that stupid ;-) | 15:44 |
| aspiers | well, maybe I am in other ways, but not this one | 15:45 |
| AJaeger | aspiers: show me your change and the log file for it, please | 15:45 |
| aspiers | AJaeger: ^^^^ | 15:45 |
| AJaeger | aspiers: where's the log file? | 15:45 |
| aspiers | I'm creating it | 15:45 |
| AJaeger | aspiers: push this to gerrit and let's discuss there, please. | 15:46 |
| aspiers | AJaeger: https://review.openstack.org/#/c/590406/1 | 15:50 |
| *** kopecmartin has quit IRC | 15:53 | |
| AJaeger | aspiers: thanks. You get it 4 times for different documents | 15:55 |
| aspiers | https://gist.github.com/aspiers/b6c5a9bd4e9c39be700bf7e296d424e7 | 15:55 |
| aspiers | but it's the same every time | 15:56 |
| aspiers | checking consistency... /home/adam/SUSE/cloud/OpenStack/git/self-healing-sig/doc/source/meta/CONTRIBUTING.rst:: WARNING: document isn't included in any toctree | 15:56 |
| AJaeger | " toctree contains reference to nonexisting document 'meta/*'" is clear - there's no content in meta | 15:56 |
| aspiers | yes there is | 15:57 |
| aspiers | meta/CONTRIBUTING.rst | 15:57 |
| aspiers | and it's nothing to do with that being a symlink, since it happened exactly the same when it was a regular file | 15:57 |
| AJaeger | aspiers: not in your git tree. | 15:57 |
| AJaeger | wait, give me a minute | 15:57 |
| aspiers | https://review.openstack.org/#/c/590406/1/doc/source/meta/CONTRIBUTING.rst | 15:57 |
| aspiers | https://review.openstack.org/#/c/590406/1/CONTRIBUTING.rst | 15:58 |
| AJaeger | aspiers: missing :glob: - I commented on the review | 15:59 |
| AJaeger | aspiers: update your index.rst | 16:00 |
| AJaeger | aspiers: most people don't use glob, they want their content in a specified order | 16:00 |
| aspiers | that will come later when we have content :) | 16:01 |
| AJaeger | I still suggest to use meta/CONTRIBUTING in the index instead of meta/* together with glob. | 16:01 |
| AJaeger | But either works | 16:01 |
| aspiers | OK | 16:01 |
| aspiers | but yes, :glob: indeed fixes the warning, thanks! | 16:02 |
| AJaeger | aspiers: "WARNING: toctree contains reference to nonexisting document 'meta/*" isyour hint | 16:02 |
| AJaeger | meta/* is a non-existing document since you didn't turn glob on | 16:02 |
| aspiers | well the hint makes sense only if you already know the problem :) | 16:02 |
| aspiers | however I still don't understand why it is checking consistency 4 times over | 16:02 |
| AJaeger | aspiers: don't use "python setup.py build_sphinx", follow https://governance.openstack.org/tc/reference/project-testing-interface.html#documentation to use "sphinx-build -W -b html doc/source doc/build/html" | 16:04 |
| aspiers | AJaeger: this came straight from cookiecutter | 16:05 |
| AJaeger | aspiers: you're building both html and man page | 16:05 |
| AJaeger | so, I see it twice | 16:05 |
| AJaeger | aspiers: let's update cookiecutter then ... | 16:05 |
| AJaeger | aspiers: have to step out for some time... | 16:06 |
| aspiers | OK thanks! | 16:06 |
| *** pkovar has quit IRC | 16:11 | |
| *** dustins has quit IRC | 16:15 | |
| *** tosky has quit IRC | 16:39 | |
| *** pkovar has joined #openstack-doc | 17:08 | |
| *** pkovar has quit IRC | 17:15 | |
| *** jamesmcarthur has quit IRC | 17:16 | |
| aspiers | Could not import extension openstackdocstheme (exception: cannot import name logging) | 17:30 |
| aspiers | #wtf | 17:30 |
| aspiers | .tox/docs/lib/python2.7/site-packages/openstackdocstheme/ext.py:from sphinx.util import logging | 17:30 |
| edmondsw | I'm seeing something similar in nova-powervm: | 17:32 |
| edmondsw | http://paste.openstack.org/show/727756/ | 17:32 |
| edmondsw | I do have openstackdocstheme listed in doc/requirements.txt but apparently rtd is not using that file? | 17:33 |
| edmondsw | anyone know how to resolve this? | 17:33 |
| aspiers | I found that you need to use tox -r to rebuild a tox environment when adding new requirements | 17:33 |
| aspiers | not sure if that applies for you | 17:33 |
| edmondsw | no, wouldn't help my case | 17:35 |
| aspiers | https://github.com/sphinx-doc/sphinx/pull/3267 | 17:35 |
| aspiers | suggests that sphinx.util.logging was added in Sphinx 1.6 | 17:35 |
| aspiers | yet my requirements.txt has sphinx>=1.1.2,!=1.2.0,!=1.3b1,<1.3 | 17:35 |
| edmondsw | my error was a little different, not about logging | 17:36 |
| aspiers | oh, your environment is missing the openstackdocstheme module | 17:37 |
| aspiers | are you building via tox? | 17:38 |
| edmondsw | no, building in rtd | 17:39 |
| edmondsw | we recently moved our docs requirements from test-requirements.txt to doc/requirements.txt ... looks like I need to update rtd on that | 17:39 |
| edmondsw | I can build fine from tox | 17:41 |
| edmondsw | ok, I figured out how to tell rtd to use doc/requirements, but now I get a new error: http://paste.openstack.org/show/727757/ | 17:41 |
| edmondsw | any ideas? | 17:41 |
| aspiers | https://github.com/openstack/openstackdocstheme/blob/master/test-requirements.txt | 17:41 |
| edmondsw | the docs build fine locally, so... | 17:41 |
| aspiers | should rtd really need to build PDFs? | 17:43 |
| aspiers | I don't know anything about rtd's build environment | 17:43 |
| edmondsw | I wouldn't think so... | 17:43 |
| AJaeger | aspiers: update those requirements list... | 17:48 |
| aspiers | AJaeger: yes that works but pip should not have allowed that to happen! | 17:48 |
| AJaeger | aspiers: did you send a patch for cookiecutter | 17:48 |
| aspiers | AJaeger: yes and I even added you as reviewer | 17:49 |
| aspiers | tox+pip installed an environment which violated the requirements of openstackdocstheme | 17:49 |
| aspiers | openstackdocstheme needs sphinx >= 1.6.0 for sphinx.util.logging | 17:49 |
| aspiers | but specs-cookiecutter has sphinx>=1.1.2,!=1.2.0,!=1.3b1,<1.3 | 17:49 |
| AJaeger | aspiers: will check, thanks | 17:50 |
| AJaeger | aspiers: yeah, the pip conflict resolution is not complete, it's very simple... | 17:50 |
| aspiers | AJaeger, mugsie: the point is that pip should have errored out saying "you're asking me to do the impossible" | 17:50 |
| aspiers | ugh | 17:51 |
| aspiers | so I get hit by https://github.com/pypa/pip/issues/988 yet again | 17:51 |
| aspiers | even Ruby's gem isn't this dumb | 17:51 |
| AJaeger | aspiers: let's fix the cookiecutter for this, gave a -1 for missing this part. | 17:53 |
| aspiers | AJaeger: what's # BSD for? | 17:55 |
| AJaeger | aspiers: you never checked requirements file elsewhere? | 17:58 |
| aspiers | nope | 17:58 |
| AJaeger | we annotate all imports with their license... | 17:58 |
| AJaeger | aspiers: copied from http://git.openstack.org/cgit/openstack/requirements/tree/global-requirements.txt | 17:59 |
| AJaeger | you can update *all* entries with lines from there... | 17:59 |
| aspiers | oh ok | 17:59 |
| aspiers | the license | 17:59 |
| aspiers | AJaeger: isn't there some kind of bot for updating requirements from global-requirements? I guess that's not working for cookiecutter templates? | 18:00 |
| AJaeger | aspiers: there was - we reworked that. and indeed, it never worked for the cookiecutter templates | 18:00 |
| aspiers | AJaeger: is html_theme really needed? nova-specs doesn't have it | 18:07 |
| AJaeger | aspiers: is nova-specs using openstackdocstheme? | 18:09 |
| aspiers | ah, apparently not | 18:10 |
| aspiers | so why should self-healing-sig? | 18:10 |
| aspiers | (playing devil's advocate: I think it should, but not sure why...) | 18:10 |
| AJaeger | aspiers: you should use openstackdocstheme, oslosphinx is outdated and unmaintained | 18:10 |
| *** dtantsur has left #openstack-doc | 18:12 | |
| AJaeger | aspiers: have a nice evening! I'm off now... | 18:13 |
| openstackgerrit | Merged openstack/openstackdocstheme master: Make bg color for highlighted text less bright https://review.openstack.org/590345 | 18:21 |
| *** jamesmcarthur has joined #openstack-doc | 18:39 | |
| aspiers | AJaeger: I'm reasonably happy with this patch now, except for the sidebar | 19:31 |
| aspiers | html_theme_options = { "sidebar_mode": "toc" } didn't really improve things either | 19:32 |
| aspiers | hrm, I have an idea | 19:33 |
| *** pcaruana has quit IRC | 19:33 | |
| *** nicolasbock has quit IRC | 20:11 | |
| *** jamesmcarthur has quit IRC | 20:56 | |
| *** jamesmcarthur has joined #openstack-doc | 21:03 | |
| *** diablo_rojo has joined #openstack-doc | 21:23 | |
| *** jamesmcarthur has quit IRC | 21:49 | |
| *** jamesmcarthur has joined #openstack-doc | 21:56 | |
| *** jamesmcarthur has quit IRC | 22:09 | |
| *** rcernin has joined #openstack-doc | 22:09 | |
| *** tosky has joined #openstack-doc | 22:30 | |
| *** diablo_rojo has quit IRC | 22:55 | |
| *** evrardjp has quit IRC | 22:55 | |
| *** tpsilva has quit IRC | 23:10 | |
| *** tosky has quit IRC | 23:48 | |
Generated by irclog2html.py 2.15.3 by Marius Gedminas - find it at mg.pov.lt!