Thursday, 2018-08-09

*** jamesmcarthur has quit IRC00:03
*** eumel8 has quit IRC01:24
*** jamesmcarthur has joined #openstack-doc02:21
*** jamesmcarthur has quit IRC03:30
*** jamesmcarthur has joined #openstack-doc04:22
*** jamesmcarthur has quit IRC04:26
*** kopecmartin has joined #openstack-doc05:31
*** nicolasbock has joined #openstack-doc05:34
*** eumel8 has joined #openstack-doc05:36
*** pkovar has joined #openstack-doc05:59
*** AJaeger has quit IRC06:16
*** AJaeger has joined #openstack-doc06:19
*** nicolasbock has quit IRC06:35
*** pcaruana has joined #openstack-doc06:38
*** nicolasbock has joined #openstack-doc06:41
*** evrardjp has joined #openstack-doc06:54
*** masakif has joined #openstack-doc06:59
*** masakif is now known as masakif_07:00
*** masakif_ is now known as masakif__07:00
*** masakif__ is now known as masakif07:00
*** masakif has quit IRC07:00
*** masakif has joined #openstack-doc07:01
*** rcernin has quit IRC07:16
openstackgerritOpenStack Proposal Bot proposed openstack/api-site master: Imported Translations from Zanata
openstackgerritOpenStack Proposal Bot proposed openstack/openstack-manuals master: Imported Translations from Zanata
openstackgerritOpenStack Proposal Bot proposed openstack/training-guides master: Imported Translations from Zanata
openstackgerritOpenStack Proposal Bot proposed openstack/security-doc master: Imported Translations from Zanata
*** tosky has joined #openstack-doc07:52
openstackgerritMerged openstack/api-site master: Imported Translations from Zanata
ianychoiAJaeger, dhellmann - thanks a lot for kind comments and I would like to select one project and implement as a prototype :)08:04
openstackgerritMerged openstack/openstack-manuals master: Imported Translations from Zanata
openstackgerritMerged openstack/training-guides master: Imported Translations from Zanata
*** KeithMnemonic has quit IRC08:23
*** dtantsur|afk is now known as dtantsur08:33
*** masakif has quit IRC09:04
openstackgerritMerged openstack/security-doc master: Imported Translations from Zanata
*** pkovar has quit IRC09:56
*** pkovar has joined #openstack-doc11:04
*** snapiri has quit IRC11:25
*** snapiri has joined #openstack-doc11:25
*** jamesmcarthur has joined #openstack-doc12:23
*** jamesmcarthur has quit IRC12:27
scasgood 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
AJaegerscas: any time you want ;)12:30
AJaegerscas: once your repo is in governance repo listed as official12:31
scasah. still unmerged12:31
AJaegerscas: 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
AJaegerSo, publish what you have, and once you're happy (better: your team is), then add to index file.12:32 :)12:32
scasi digress, but that makes sense12:33
AJaegerscas: 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
scasi have to see what all has been merged. the governance change is outstanding from the repo shuffle12:35
scaseverything is in-repo at this point, including the doc build job. i should be able to make the switch there, no?12:37
scasi'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 eye12:39
scasi'm not disparaging anyone but myself, and i don't mind being called out :)12:41
AJaegerscas: yes, do it in-repo12:41
AJaegerscas: go ahead and just do it.12:41
AJaegerscas: I'm happy to review your change and +1, just tell me...12:42
scasthat'll work for me. self-review is always biased12:42
*** oanson has joined #openstack-doc12:42
*** tpsilva has joined #openstack-doc12:44
*** edmondsw has joined #openstack-doc12:45
*** ianychoi has quit IRC12:49
*** jamesmcarthur has joined #openstack-doc13:02
scaslike 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. exists for master and for stable/queens13:10
*** dustins has joined #openstack-doc13:17
*** edmondsw has quit IRC13:29
*** edmondsw has joined #openstack-doc13:37
*** edmondsw has quit IRC13:41
*** edmondsw has joined #openstack-doc13:48
openstackgerritPetr Kovar proposed openstack/openstack-manuals master: [WIP] Add www pages for Stein
pkovarcores: looks like too many projects haven't yet branched for rocky, hence the wip status ^^14:00
*** amotoki_ is now known as amotoki14:01
kopecmartinpkovar, hi14:02
pkovarhello kopecmartin14:02
kopecmartinpkovar, it seems this patch
kopecmartincaused a bug, but it's a quick fix14:02
kopecmartinthe color is too bright now :/
kopecmartinI've created a bug for that too
openstackLaunchpad bug 1785994 in openstack-doc-tools "Too bright highlight color" [Undecided,New]14:03
pkovarkopecmartin: thanks14:08
pkovarchason: fyi, looks like we need more css tweaking in openstackdocstheme ^^14:08
pkovarkopecmartin: let me try a quick fix14:12
kopecmartinpkovar, thanks14:13
pkovarthough i am pretty color blind :)14:13
pkovarbut we can iterate14:13
pkovarand we will need a new release of the theme package14:14
*** KeithMnemonic has joined #openstack-doc14:19
openstackgerritPetr Kovar proposed openstack/openstackdocstheme master: Make bg color for highlighted text less bright
pkovarkopecmartin: ^14:22
kopecmartinpkovar, looks much better, thanks14:26
pkovarthanks for the heads up, kopecmartin14:26
*** dtantsur is now known as dtantsur|brb14:43
*** dtantsur|brb is now known as dtantsur15:29
aspiersany Sphinx experts around? I'm wondering how to avoid "WARNING: document isn't included in any toctree"15:41
AJaegeraspiers: add it to an index file ;)15:44
aspiersalso, why do I get this same error 4 times from "tox -e docs"?15:44
aspiersAJaeger: duh, I already did that :)15:44
aspiersAJaeger: I'm not that stupid ;-)15:44
aspierswell, maybe I am in other ways, but not this one15:45
AJaegeraspiers: show me your change and the log file for it, please15:45
aspiersAJaeger: ^^^^15:45
AJaegeraspiers: where's the log file?15:45
aspiersI'm creating it15:45
AJaegeraspiers: push this to gerrit and let's discuss there, please.15:46
*** kopecmartin has quit IRC15:53
AJaegeraspiers: thanks. You get it 4 times for different documents15:55
aspiersbut it's the same every time15:56
aspierschecking consistency... /home/adam/SUSE/cloud/OpenStack/git/self-healing-sig/doc/source/meta/CONTRIBUTING.rst:: WARNING: document isn't included in any toctree15:56
AJaeger" toctree contains reference to nonexisting document 'meta/*'" is clear - there's no content in meta15:56
aspiersyes there is15:57
aspiersand it's nothing to do with that being a symlink, since it happened exactly the same when it was a regular file15:57
AJaegeraspiers: not in your git tree.15:57
AJaegerwait, give me a minute15:57
AJaegeraspiers: missing :glob:  - I commented on the review15:59
AJaegeraspiers: update your index.rst16:00
AJaegeraspiers: most people don't use glob, they want their content in a specified order16:00
aspiersthat will come later when we have content :)16:01
AJaegerI still suggest to use meta/CONTRIBUTING in the index instead of meta/* together with glob.16:01
AJaegerBut either works16:01
aspiersbut yes, :glob: indeed fixes the warning, thanks!16:02
AJaegeraspiers: "WARNING: toctree contains reference to nonexisting document 'meta/*" isyour hint16:02
AJaegermeta/* is a non-existing document since you didn't turn glob on16:02
aspierswell the hint makes sense only if you already know the problem :)16:02
aspiershowever I still don't understand why it is checking consistency 4 times over16:02
AJaegeraspiers: don't use "python build_sphinx", follow to use "sphinx-build -W -b html doc/source doc/build/html"16:04
aspiersAJaeger: this came straight from cookiecutter16:05
AJaegeraspiers: you're building both html and man page16:05
AJaegerso, I see it twice16:05
AJaegeraspiers: let's update cookiecutter then ...16:05
AJaegeraspiers: have to step out for some time...16:06
aspiersOK thanks!16:06
*** pkovar has quit IRC16:11
*** dustins has quit IRC16:15
*** tosky has quit IRC16:39
*** pkovar has joined #openstack-doc17:08
*** pkovar has quit IRC17:15
*** jamesmcarthur has quit IRC17:16
aspiersCould not import extension openstackdocstheme (exception: cannot import name logging)17:30
aspiers.tox/docs/lib/python2.7/site-packages/openstackdocstheme/ sphinx.util import logging17:30
edmondswI'm seeing something similar in nova-powervm:17:32
edmondswI do have openstackdocstheme listed in doc/requirements.txt but apparently rtd is not using that file?17:33
edmondswanyone know how to resolve this?17:33
aspiersI found that you need to use tox -r to rebuild a tox environment when adding new requirements17:33
aspiersnot sure if that applies for you17:33
edmondswno, wouldn't help my case17:35
aspierssuggests that sphinx.util.logging was added in Sphinx 1.617:35
aspiersyet my requirements.txt has sphinx>=1.1.2,!=1.2.0,!=1.3b1,<1.317:35
edmondswmy error was a little different, not about logging17:36
aspiersoh, your environment is missing the openstackdocstheme module17:37
aspiersare you building via tox?17:38
edmondswno, building in rtd17:39
edmondswwe recently moved our docs requirements from test-requirements.txt to doc/requirements.txt ... looks like I need to update rtd on that17:39
edmondswI can build fine from tox17:41
edmondswok, I figured out how to tell rtd to use doc/requirements, but now I get a new error:
edmondswany ideas?17:41
edmondswthe docs build fine locally, so...17:41
aspiersshould rtd really need to build PDFs?17:43
aspiersI don't know anything about rtd's build environment17:43
edmondswI wouldn't think so...17:43
AJaegeraspiers: update those requirements list...17:48
aspiersAJaeger: yes that works but pip should not have allowed that to happen!17:48
AJaegeraspiers: did you send a patch for cookiecutter17:48
aspiersAJaeger: yes and I even added you as reviewer17:49
aspierstox+pip installed an environment which violated the requirements of openstackdocstheme17:49
aspiersopenstackdocstheme needs sphinx >= 1.6.0 for sphinx.util.logging17:49
aspiersbut specs-cookiecutter has sphinx>=1.1.2,!=1.2.0,!=1.3b1,<1.317:49
AJaegeraspiers: will check, thanks17:50
AJaegeraspiers: yeah, the pip conflict resolution is not complete, it's very simple...17:50
aspiersAJaeger, mugsie: the point is that pip should have errored out saying "you're asking me to do the impossible"17:50
aspiersso I get hit by yet again17:51
aspierseven Ruby's gem isn't this dumb17:51
AJaegeraspiers: let's fix the cookiecutter for this, gave a -1 for missing this part.17:53
aspiersAJaeger: what's # BSD for?17:55
AJaegeraspiers: you never checked requirements file elsewhere?17:58
AJaegerwe annotate all imports with their license...17:58
AJaegeraspiers: copied from
AJaegeryou can update *all* entries with lines from there...17:59
aspiersoh ok17:59
aspiersthe license17:59
aspiersAJaeger: isn't there some kind of bot for updating requirements from global-requirements? I guess that's not working for cookiecutter templates?18:00
AJaegeraspiers: there was - we reworked that. and indeed, it never worked for the cookiecutter templates18:00
aspiersAJaeger: is html_theme really needed? nova-specs doesn't have it18:07
AJaegeraspiers: is nova-specs using openstackdocstheme?18:09
aspiersah, apparently not18:10
aspiersso why should self-healing-sig?18:10
aspiers(playing devil's advocate: I think it should, but not sure why...)18:10
AJaegeraspiers: you should use openstackdocstheme, oslosphinx is outdated and unmaintained18:10
*** dtantsur has left #openstack-doc18:12
AJaegeraspiers: have a nice evening! I'm off now...18:13
openstackgerritMerged openstack/openstackdocstheme master: Make bg color for highlighted text less bright
*** jamesmcarthur has joined #openstack-doc18:39
aspiersAJaeger: I'm reasonably happy with this patch now, except for the sidebar19:31
aspiershtml_theme_options = { "sidebar_mode": "toc" } didn't really improve things either19:32
aspiershrm, I have an idea19:33
*** pcaruana has quit IRC19:33
*** nicolasbock has quit IRC20:11
*** jamesmcarthur has quit IRC20:56
*** jamesmcarthur has joined #openstack-doc21:03
*** diablo_rojo has joined #openstack-doc21:23
*** jamesmcarthur has quit IRC21:49
*** jamesmcarthur has joined #openstack-doc21:56
*** jamesmcarthur has quit IRC22:09
*** rcernin has joined #openstack-doc22:09
*** tosky has joined #openstack-doc22:30
*** diablo_rojo has quit IRC22:55
*** evrardjp has quit IRC22:55
*** tpsilva has quit IRC23:10
*** tosky has quit IRC23:48

Generated by 2.15.3 by Marius Gedminas - find it at!