Tuesday, 2018-01-16

*** masaki has joined #openstack-doc00:03
*** bigdogstl has joined #openstack-doc00:19
*** dmacpher has quit IRC00:23
*** bigdogstl has quit IRC00:25
*** yangyapeng has quit IRC00:27
*** fragatina has joined #openstack-doc00:31
*** yamamoto has joined #openstack-doc00:36
*** fragatina has quit IRC00:37
*** fragatina has joined #openstack-doc00:40
*** bigdogstl has joined #openstack-doc00:51
*** tosky has quit IRC00:52
*** fragatina has quit IRC00:52
*** yangyapeng has joined #openstack-doc01:00
*** yangyapeng has quit IRC01:04
*** bigdogstl has quit IRC01:07
*** openstackgerrit has joined #openstack-doc01:09
openstackgerritJeremy Liu proposed openstack/security-doc master: Add a checklist item for Glance Image Service  https://review.openstack.org/53348901:09
*** yangyapeng has joined #openstack-doc01:14
*** bigdogstl has joined #openstack-doc02:00
*** threestrands_ has joined #openstack-doc02:02
*** jappleii__ has quit IRC02:04
*** bigdogstl has quit IRC02:05
*** bigdogstl has joined #openstack-doc02:08
*** bigdogstl has quit IRC02:17
*** edmondsw has quit IRC02:34
*** bigdogstl has joined #openstack-doc02:52
*** bigdogstl has quit IRC02:58
openstackgerritlei zhang proposed openstack/openstackdocstheme master: Update the description of "giturl"  https://review.openstack.org/53385103:02
*** vijaykc4 has joined #openstack-doc03:03
*** bigdogstl has joined #openstack-doc03:04
*** vijaykc4 has quit IRC03:05
*** nicolasbock has quit IRC03:15
*** vijaykc4 has joined #openstack-doc03:16
*** bigdogstl has quit IRC03:19
*** vijaykc4 has quit IRC03:20
*** vijaykc4 has joined #openstack-doc03:21
*** vijaykc4 has quit IRC03:33
*** yamamoto_ has joined #openstack-doc03:39
*** yamamoto has quit IRC03:43
*** bigdogstl has joined #openstack-doc03:46
*** edmondsw has joined #openstack-doc03:47
*** bigdogstl has quit IRC03:51
*** edmondsw has quit IRC03:52
*** vijaykc4 has joined #openstack-doc04:14
*** vijaykc4 has quit IRC04:16
*** vijaykc4 has joined #openstack-doc04:16
*** vijaykc4 has quit IRC04:21
*** emme has joined #openstack-doc04:22
*** bigdogstl has joined #openstack-doc04:26
*** bigdogstl has quit IRC04:37
*** bigdogstl has joined #openstack-doc04:46
*** vijaykc4 has joined #openstack-doc04:50
*** bigdogstl has quit IRC04:51
*** emme has quit IRC04:54
*** bigdogstl has joined #openstack-doc04:58
*** cburgess has quit IRC05:02
*** bigdogstl has quit IRC05:03
*** vijaykc4 has quit IRC05:06
*** cburgess has joined #openstack-doc05:08
*** cburgess has quit IRC05:12
*** cburgess has joined #openstack-doc05:13
*** vijaykc4 has joined #openstack-doc05:15
openstackgerritlei zhang proposed openstack/openstackdocstheme master: Fix the Neutron API Reference cannot derive source file URL  https://review.openstack.org/53408105:18
*** vijaykc4 has quit IRC05:20
*** vijaykc4 has joined #openstack-doc05:21
*** bigdogstl has joined #openstack-doc05:23
*** bigdogstl has quit IRC05:30
*** vijaykc4 has quit IRC05:32
*** bigdogstl has joined #openstack-doc05:42
*** bigdogstl has quit IRC05:55
*** vijaykc4 has joined #openstack-doc06:00
*** ccollett has joined #openstack-doc06:02
*** charcol has quit IRC06:05
*** bigdogstl has joined #openstack-doc06:11
*** bigdogstl has quit IRC06:20
*** bigdogstl has joined #openstack-doc06:26
*** bigdogstl has quit IRC06:41
*** vijaykc4 has quit IRC06:53
*** ccollett has quit IRC07:01
AJaegerstephenfin, https://review.openstack.org/532943 shows that openstackdocstheme 1.18.1 works with giturls.07:05
*** suyog has quit IRC07:09
*** rcernin has quit IRC07:14
*** bigdogstl has joined #openstack-doc07:15
*** threestrands_ has quit IRC07:18
*** bigdogstl has quit IRC07:23
*** edmondsw has joined #openstack-doc07:24
*** bigdogstl has joined #openstack-doc07:26
openstackgerritlei zhang proposed openstack/openstackdocstheme master: Update the description of "giturl"  https://review.openstack.org/53385107:28
*** edmondsw has quit IRC07:28
*** bigdogstl has quit IRC07:31
*** tesseract has joined #openstack-doc08:05
openstackgerritChason Chan proposed openstack/openstack-manuals master: Make the title of Installation Guide more conspicuous  https://review.openstack.org/53416408:10
openstackgerritOpenStack Proposal Bot proposed openstack/training-guides master: Imported Translations from Zanata  https://review.openstack.org/53416808:12
openstackgerritChason Chan proposed openstack/openstack-manuals master: Make the title of Installation Guide more conspicuous  https://review.openstack.org/53416408:14
*** bigdogstl has joined #openstack-doc08:18
*** bigdogstl has quit IRC08:29
*** egallen has joined #openstack-doc08:44
*** jpena|off is now known as jpena08:46
*** bigdogstl has joined #openstack-doc08:51
*** bigdogstl has quit IRC08:56
*** masaki has quit IRC09:01
*** tulivu has joined #openstack-doc09:01
*** edmondsw has joined #openstack-doc09:12
*** egallen has quit IRC09:16
*** edmondsw has quit IRC09:17
*** bigdogstl has joined #openstack-doc09:20
*** egallen has joined #openstack-doc09:26
*** bigdogstl has quit IRC09:31
*** egallen has quit IRC09:39
*** egallen has joined #openstack-doc09:56
*** bigdogstl has joined #openstack-doc10:00
*** yangyapeng has quit IRC10:04
*** yangyapeng has joined #openstack-doc10:04
*** bigdogstl has quit IRC10:11
*** tpsilva has joined #openstack-doc10:25
*** AJaeger has quit IRC10:26
*** tosky has joined #openstack-doc10:27
openstackgerritMerged openstack/security-doc master: Add a checklist item for Glance Image Service  https://review.openstack.org/53348910:31
openstackgerritMerged openstack/security-doc master: Update identity/checklist section in security-guide  https://review.openstack.org/53345310:31
*** AJaeger has joined #openstack-doc10:32
*** alexchadin has joined #openstack-doc10:47
*** alexchadin has quit IRC10:49
*** alexchadin has joined #openstack-doc10:49
*** egallen has quit IRC10:59
*** edmondsw has joined #openstack-doc11:00
*** edmondsw has quit IRC11:05
*** bigdogstl has joined #openstack-doc11:12
*** pkovar has joined #openstack-doc11:14
*** bigdogstl has quit IRC11:19
*** egallen has joined #openstack-doc11:23
*** yamamoto_ has quit IRC11:27
*** egallen has quit IRC11:43
*** oanson has quit IRC11:48
*** oanson has joined #openstack-doc11:50
*** edmondsw has joined #openstack-doc12:03
*** oanson has quit IRC12:10
*** oanson has joined #openstack-doc12:12
*** bigdogstl has joined #openstack-doc12:16
*** nicolasbock has joined #openstack-doc12:22
*** bigdogstl has quit IRC12:23
*** yamamoto has joined #openstack-doc12:26
*** pcaruana has joined #openstack-doc12:33
*** jpena is now known as jpena|lunch12:35
*** bigdogstl has joined #openstack-doc12:38
*** bigdogstl has quit IRC12:43
*** bigdogstl has joined #openstack-doc12:52
*** yangyapeng has quit IRC12:56
*** strigazi has quit IRC12:56
*** bigdogstl has quit IRC12:58
*** strigazi has joined #openstack-doc13:04
*** yangyapeng has joined #openstack-doc13:22
*** bigdogstl has joined #openstack-doc13:23
*** bigdogstl has quit IRC13:28
*** yamamoto_ has joined #openstack-doc13:32
*** rbowen has joined #openstack-doc13:33
*** bigdogstl has joined #openstack-doc13:33
openstackgerritMerged openstack/training-guides master: Imported Translations from Zanata  https://review.openstack.org/53416813:35
*** yamamoto_ has quit IRC13:35
*** yamamoto has quit IRC13:35
*** jpena|lunch is now known as jpena13:39
*** tulivu has quit IRC13:40
*** bigdogstl has quit IRC13:43
*** tulivu has joined #openstack-doc13:46
*** yamamoto has joined #openstack-doc13:47
*** tulivu has quit IRC13:47
*** tulivu_ has joined #openstack-doc13:47
*** tulivu_ has quit IRC13:47
*** tulivu has joined #openstack-doc13:47
*** yamamoto has quit IRC13:52
*** fragatina has joined #openstack-doc14:02
*** fragatina has quit IRC14:02
*** fragatina has joined #openstack-doc14:03
*** mihalis68 has joined #openstack-doc14:06
*** yamamoto has joined #openstack-doc14:17
*** yamamoto has quit IRC14:22
pkovarAJaeger: got a q wrt updating documentation for local building openstack docs, is it better to recommend using sphinx-build or tox -e docs ?14:50
pkovarsphinx-build would be consistent with https://governance.openstack.org/tc/reference/project-testing-interface.html#documentation14:51
stephenfinpkovar: tox should call sphinx-build _and_ handle the nitty-gritty of building your environment. I'd use that, personally14:56
pkovargood point, seems to be better suited for first time use case then14:56
* AJaeger agrees with stephenfin14:57
pkovarwill have a patch ready shortly, will cc you folks14:57
pkovarthanks14:57
*** emme has joined #openstack-doc15:00
*** uberjay_ has quit IRC15:00
*** yamamoto has joined #openstack-doc15:03
*** yamamoto has quit IRC15:03
*** uberjay has joined #openstack-doc15:04
*** emme has quit IRC15:05
*** uberjay has quit IRC15:06
*** alexchadin has quit IRC15:07
*** emme has joined #openstack-doc15:09
*** yamamoto has joined #openstack-doc15:12
*** bigdogstl has joined #openstack-doc15:13
*** uberjay has joined #openstack-doc15:15
*** yamamoto has quit IRC15:17
pkovarany suggestions as to how to collectively refer to docs repos such as security-doc and openstack-manuals?15:20
pkovarwould "documentation repos" be confusing?15:20
pkovar"documentation repos as opposed to project repos"15:21
pkovarnot sure if that distinction is clear15:21
pkovarbut we kinda need it for doc contrib guide15:22
pkovarright now its heavily openstack-manuals focused15:22
*** bigdogstl has quit IRC15:22
pkovaranother tricky part is that e.g. security-doc tox environment is not really consistent with contributor-guide15:26
pkovarhard to provide common docs for those!15:26
*** emme has quit IRC15:33
*** emme has joined #openstack-doc15:34
*** tulivu has quit IRC15:39
dhellmannpkovar : you're trying to talk about them collectively? if you give more context I might be able to help with phrasing.15:39
pkovardhellmann: basically, i'd like to separate this section https://docs.openstack.org/doc-contrib-guide/docs-builds.html#build-workflow15:40
pkovarinto project repos section15:40
pkovarand "documentation repos" section15:41
pkovarthe former would talk about tox -e docs15:41
dhellmannwe could also add build instructions directly to the project repos in their contributor docs15:41
pkovarthe latter about what's there already15:41
dhellmannthe instructions that are there now only apply to the openstack-manuals repo, right?15:42
pkovarcorrect, but wouldn't that need a lot of duplicated content?15:42
dhellmannso you could talk about that repo specifically, and then "any other repositories"15:42
pkovaryes, correct15:42
dhellmannor even "all other repositories with documentation"15:42
pkovarcan we assume that a project repo is a repo with documentation?15:43
dhellmannthe problem with putting instructions in this contrib guide is that if I'm looking at the oslo.config source tree trying to figure out how to build something I don't know to go look at instructions published from somewhere else.15:43
dhellmannmost project repos have docs; not all repos with docs are project repos15:43
*** fragatina has quit IRC15:43
pkovarwell, then there are readme files that should in fact also contain the info15:43
pkovaron building15:44
dhellmannyes, at least a pointer in the repo to where the docs are published is a good idea15:44
*** fragatina has joined #openstack-doc15:44
*** emme has quit IRC15:47
pkovarlet me submit a patch and then we can iterate, as always :)15:48
dhellmann++15:49
pkovar"other repositories with documentation" sounds good to me though its a bit long15:49
*** bigdogstl has joined #openstack-doc15:50
pkovarfor headings, etc.15:50
*** fragatina has quit IRC15:51
*** fragatina has joined #openstack-doc15:51
*** jamesmcarthur has joined #openstack-doc15:52
pkovarfor the o-m section, we could really just point to https://github.com/openstack/openstack-manuals/blob/master/README.rst and save everybody's time :)15:53
dhellmannyou could just say "other repositories"15:53
dhellmannand clarify in the body of the text that not all of them will have documentation15:53
pkovaror that15:55
AJaegerpkovar, dhellmann: security-doc, api-site and openstack-manuals are all together in this IMHO15:55
dhellmannAJaeger : why is security-doc not just using the regular sphinx build steps?15:56
dhellmannI always forget about api-site, that one does need the special stuff15:56
pkovarthere are multiple docs in security-doc15:56
AJaegerdhellmann: it has several documents15:56
dhellmannsigh15:57
dhellmannok15:57
pkovar;)15:57
AJaegerdhellmann: we could split that into several ones15:57
AJaegerdhellmann: initially it was a docbook XML guide in security-doc as well...15:57
*** emme has joined #openstack-doc15:57
*** yamamoto has joined #openstack-doc15:58
*** emme has quit IRC16:00
*** yamamoto has quit IRC16:01
*** yamamoto has joined #openstack-doc16:01
*** yamamoto has quit IRC16:01
*** bigdogstl has quit IRC16:02
*** mihalis68 has quit IRC16:26
*** carl_baldwin has quit IRC16:32
*** krtaylor has quit IRC16:36
*** jpena is now known as jpena|off16:37
pkovarany objections if we nuke https://docs.openstack.org/doc-contrib-guide/quickstart/developers.html and https://docs.openstack.org/doc-contrib-guide/quickstart/new-projects.html ?16:40
pkovar(and update the infra guide accordingly)16:40
*** yamamoto has joined #openstack-doc16:41
*** jpena|off is now known as jpena16:41
pkovarbut we kinda agreed on that at the ptg, but16:41
AJaegerwhere do you want to add it? http://docs.openstack.org/project-team-guide/16:43
AJaegerpkovar: so, first merge it there - then remove from openstack-manuals.16:43
pkovari meant https://docs.openstack.org/infra/manual/16:44
pkovarbut sounds good16:44
AJaegerpkovar: ok, figure out what should go where, let it merge, then remove - that works fine for me...16:45
pkovarman, the toc of https://docs.openstack.org/project-team-guide/  is looong16:45
*** yamamoto has quit IRC16:46
dhellmannpkovar : yeah, I think the project-team-guide is probably a better location for any of that content that needs to be kept.16:46
*** emme has joined #openstack-doc16:46
dhellmannalthough it looks like the team guide already links over to the contributor guide16:46
dhellmannETOOMANYGUIDES16:46
pkovaryes, it does16:47
*** bigdogstl has joined #openstack-doc16:47
pkovaryes, to much documentation !16:47
pkovartoo, even16:47
dhellmannexplaining which jobs to configure sounds like an infra manual topic16:47
pkovaryes16:47
dhellmannis anything in https://docs.openstack.org/doc-contrib-guide/quickstart/developers.html still relevant?16:48
pkovari also found out i am much better at removing content than adding it!16:48
dhellmannheh16:48
*** bigdogstl has quit IRC16:51
*** emme has quit IRC16:52
*** bigdogstl has joined #openstack-doc16:54
*** bigdogstl has quit IRC16:59
*** tesseract has quit IRC17:21
*** bigdogstl has joined #openstack-doc17:28
*** openstackgerrit has quit IRC17:33
*** bigdogstl has quit IRC17:38
*** yamamoto has joined #openstack-doc17:44
*** fragatina has quit IRC17:49
*** yamamoto has quit IRC17:58
*** emme has joined #openstack-doc17:59
*** bigdogstl has joined #openstack-doc18:06
*** bigdogstl has quit IRC18:11
*** bigdogstl has joined #openstack-doc18:19
*** bigdogstl has quit IRC18:24
*** bigdogstl has joined #openstack-doc18:26
*** bigdogstl has quit IRC18:35
*** openstackgerrit has joined #openstack-doc18:38
openstackgerritPetr Kovar proposed openstack/openstack-manuals master: Update Building documentation and README  https://review.openstack.org/53440518:38
*** jpena is now known as jpena|off18:45
openstackgerritKendall Nelson proposed openstack/contributor-guide master: Add Task Tracking to Code&Docs  https://review.openstack.org/52811918:57
*** eumel8 has quit IRC18:58
*** fragatina has joined #openstack-doc19:15
*** pkovar has quit IRC19:25
*** bigdogstl has joined #openstack-doc19:38
*** bigdogstl has quit IRC19:48
*** pcaruana has quit IRC19:50
*** dustins has joined #openstack-doc19:53
*** emme has quit IRC19:55
*** bigdogstl has joined #openstack-doc20:09
*** bigdogstl has quit IRC20:14
*** bigdogstl has joined #openstack-doc20:28
*** bigdogstl has quit IRC20:38
*** bigdogstl has joined #openstack-doc21:15
*** threestrands_ has joined #openstack-doc21:18
*** bigdogstl has quit IRC21:45
*** bigdogstl has joined #openstack-doc21:51
*** rbowen has quit IRC22:02
*** bigdogstl has quit IRC22:03
*** bigdogstl has joined #openstack-doc22:05
*** dustins has quit IRC22:18
*** bigdogstl has quit IRC22:22
*** rcernin has joined #openstack-doc22:31
*** jamesmcarthur has quit IRC22:36
*** jamesmcarthur has joined #openstack-doc22:43
*** tpsilva has quit IRC22:54
*** edmondsw has quit IRC22:55
*** edmondsw has joined #openstack-doc22:56
*** jamesmcarthur has quit IRC22:59
*** edmondsw has quit IRC23:00
*** bigdogstl has joined #openstack-doc23:00
*** jamesmcarthur has joined #openstack-doc23:00
*** bigdogstl has quit IRC23:08
*** bigdogstl has joined #openstack-doc23:16
*** bigdogstl has quit IRC23:22
*** bigdogstl has joined #openstack-doc23:33
*** charcol has joined #openstack-doc23:35
*** suyog has joined #openstack-doc23:35
*** bigdogstl has quit IRC23:45
*** suyog has quit IRC23:53
*** suyog has joined #openstack-doc23:58

Generated by irclog2html.py 2.15.3 by Marius Gedminas - find it at mg.pov.lt!