*** masaki has joined #openstack-doc | 00:03 | |
*** bigdogstl has joined #openstack-doc | 00:19 | |
*** dmacpher has quit IRC | 00:23 | |
*** bigdogstl has quit IRC | 00:25 | |
*** yangyapeng has quit IRC | 00:27 | |
*** fragatina has joined #openstack-doc | 00:31 | |
*** yamamoto has joined #openstack-doc | 00:36 | |
*** fragatina has quit IRC | 00:37 | |
*** fragatina has joined #openstack-doc | 00:40 | |
*** bigdogstl has joined #openstack-doc | 00:51 | |
*** tosky has quit IRC | 00:52 | |
*** fragatina has quit IRC | 00:52 | |
*** yangyapeng has joined #openstack-doc | 01:00 | |
*** yangyapeng has quit IRC | 01:04 | |
*** bigdogstl has quit IRC | 01:07 | |
*** openstackgerrit has joined #openstack-doc | 01:09 | |
openstackgerrit | Jeremy Liu proposed openstack/security-doc master: Add a checklist item for Glance Image Service https://review.openstack.org/533489 | 01:09 |
---|---|---|
*** yangyapeng has joined #openstack-doc | 01:14 | |
*** bigdogstl has joined #openstack-doc | 02:00 | |
*** threestrands_ has joined #openstack-doc | 02:02 | |
*** jappleii__ has quit IRC | 02:04 | |
*** bigdogstl has quit IRC | 02:05 | |
*** bigdogstl has joined #openstack-doc | 02:08 | |
*** bigdogstl has quit IRC | 02:17 | |
*** edmondsw has quit IRC | 02:34 | |
*** bigdogstl has joined #openstack-doc | 02:52 | |
*** bigdogstl has quit IRC | 02:58 | |
openstackgerrit | lei zhang proposed openstack/openstackdocstheme master: Update the description of "giturl" https://review.openstack.org/533851 | 03:02 |
*** vijaykc4 has joined #openstack-doc | 03:03 | |
*** bigdogstl has joined #openstack-doc | 03:04 | |
*** vijaykc4 has quit IRC | 03:05 | |
*** nicolasbock has quit IRC | 03:15 | |
*** vijaykc4 has joined #openstack-doc | 03:16 | |
*** bigdogstl has quit IRC | 03:19 | |
*** vijaykc4 has quit IRC | 03:20 | |
*** vijaykc4 has joined #openstack-doc | 03:21 | |
*** vijaykc4 has quit IRC | 03:33 | |
*** yamamoto_ has joined #openstack-doc | 03:39 | |
*** yamamoto has quit IRC | 03:43 | |
*** bigdogstl has joined #openstack-doc | 03:46 | |
*** edmondsw has joined #openstack-doc | 03:47 | |
*** bigdogstl has quit IRC | 03:51 | |
*** edmondsw has quit IRC | 03:52 | |
*** vijaykc4 has joined #openstack-doc | 04:14 | |
*** vijaykc4 has quit IRC | 04:16 | |
*** vijaykc4 has joined #openstack-doc | 04:16 | |
*** vijaykc4 has quit IRC | 04:21 | |
*** emme has joined #openstack-doc | 04:22 | |
*** bigdogstl has joined #openstack-doc | 04:26 | |
*** bigdogstl has quit IRC | 04:37 | |
*** bigdogstl has joined #openstack-doc | 04:46 | |
*** vijaykc4 has joined #openstack-doc | 04:50 | |
*** bigdogstl has quit IRC | 04:51 | |
*** emme has quit IRC | 04:54 | |
*** bigdogstl has joined #openstack-doc | 04:58 | |
*** cburgess has quit IRC | 05:02 | |
*** bigdogstl has quit IRC | 05:03 | |
*** vijaykc4 has quit IRC | 05:06 | |
*** cburgess has joined #openstack-doc | 05:08 | |
*** cburgess has quit IRC | 05:12 | |
*** cburgess has joined #openstack-doc | 05:13 | |
*** vijaykc4 has joined #openstack-doc | 05:15 | |
openstackgerrit | lei zhang proposed openstack/openstackdocstheme master: Fix the Neutron API Reference cannot derive source file URL https://review.openstack.org/534081 | 05:18 |
*** vijaykc4 has quit IRC | 05:20 | |
*** vijaykc4 has joined #openstack-doc | 05:21 | |
*** bigdogstl has joined #openstack-doc | 05:23 | |
*** bigdogstl has quit IRC | 05:30 | |
*** vijaykc4 has quit IRC | 05:32 | |
*** bigdogstl has joined #openstack-doc | 05:42 | |
*** bigdogstl has quit IRC | 05:55 | |
*** vijaykc4 has joined #openstack-doc | 06:00 | |
*** ccollett has joined #openstack-doc | 06:02 | |
*** charcol has quit IRC | 06:05 | |
*** bigdogstl has joined #openstack-doc | 06:11 | |
*** bigdogstl has quit IRC | 06:20 | |
*** bigdogstl has joined #openstack-doc | 06:26 | |
*** bigdogstl has quit IRC | 06:41 | |
*** vijaykc4 has quit IRC | 06:53 | |
*** ccollett has quit IRC | 07:01 | |
AJaeger | stephenfin, https://review.openstack.org/532943 shows that openstackdocstheme 1.18.1 works with giturls. | 07:05 |
*** suyog has quit IRC | 07:09 | |
*** rcernin has quit IRC | 07:14 | |
*** bigdogstl has joined #openstack-doc | 07:15 | |
*** threestrands_ has quit IRC | 07:18 | |
*** bigdogstl has quit IRC | 07:23 | |
*** edmondsw has joined #openstack-doc | 07:24 | |
*** bigdogstl has joined #openstack-doc | 07:26 | |
openstackgerrit | lei zhang proposed openstack/openstackdocstheme master: Update the description of "giturl" https://review.openstack.org/533851 | 07:28 |
*** edmondsw has quit IRC | 07:28 | |
*** bigdogstl has quit IRC | 07:31 | |
*** tesseract has joined #openstack-doc | 08:05 | |
openstackgerrit | Chason Chan proposed openstack/openstack-manuals master: Make the title of Installation Guide more conspicuous https://review.openstack.org/534164 | 08:10 |
openstackgerrit | OpenStack Proposal Bot proposed openstack/training-guides master: Imported Translations from Zanata https://review.openstack.org/534168 | 08:12 |
openstackgerrit | Chason Chan proposed openstack/openstack-manuals master: Make the title of Installation Guide more conspicuous https://review.openstack.org/534164 | 08:14 |
*** bigdogstl has joined #openstack-doc | 08:18 | |
*** bigdogstl has quit IRC | 08:29 | |
*** egallen has joined #openstack-doc | 08:44 | |
*** jpena|off is now known as jpena | 08:46 | |
*** bigdogstl has joined #openstack-doc | 08:51 | |
*** bigdogstl has quit IRC | 08:56 | |
*** masaki has quit IRC | 09:01 | |
*** tulivu has joined #openstack-doc | 09:01 | |
*** edmondsw has joined #openstack-doc | 09:12 | |
*** egallen has quit IRC | 09:16 | |
*** edmondsw has quit IRC | 09:17 | |
*** bigdogstl has joined #openstack-doc | 09:20 | |
*** egallen has joined #openstack-doc | 09:26 | |
*** bigdogstl has quit IRC | 09:31 | |
*** egallen has quit IRC | 09:39 | |
*** egallen has joined #openstack-doc | 09:56 | |
*** bigdogstl has joined #openstack-doc | 10:00 | |
*** yangyapeng has quit IRC | 10:04 | |
*** yangyapeng has joined #openstack-doc | 10:04 | |
*** bigdogstl has quit IRC | 10:11 | |
*** tpsilva has joined #openstack-doc | 10:25 | |
*** AJaeger has quit IRC | 10:26 | |
*** tosky has joined #openstack-doc | 10:27 | |
openstackgerrit | Merged openstack/security-doc master: Add a checklist item for Glance Image Service https://review.openstack.org/533489 | 10:31 |
openstackgerrit | Merged openstack/security-doc master: Update identity/checklist section in security-guide https://review.openstack.org/533453 | 10:31 |
*** AJaeger has joined #openstack-doc | 10:32 | |
*** alexchadin has joined #openstack-doc | 10:47 | |
*** alexchadin has quit IRC | 10:49 | |
*** alexchadin has joined #openstack-doc | 10:49 | |
*** egallen has quit IRC | 10:59 | |
*** edmondsw has joined #openstack-doc | 11:00 | |
*** edmondsw has quit IRC | 11:05 | |
*** bigdogstl has joined #openstack-doc | 11:12 | |
*** pkovar has joined #openstack-doc | 11:14 | |
*** bigdogstl has quit IRC | 11:19 | |
*** egallen has joined #openstack-doc | 11:23 | |
*** yamamoto_ has quit IRC | 11:27 | |
*** egallen has quit IRC | 11:43 | |
*** oanson has quit IRC | 11:48 | |
*** oanson has joined #openstack-doc | 11:50 | |
*** edmondsw has joined #openstack-doc | 12:03 | |
*** oanson has quit IRC | 12:10 | |
*** oanson has joined #openstack-doc | 12:12 | |
*** bigdogstl has joined #openstack-doc | 12:16 | |
*** nicolasbock has joined #openstack-doc | 12:22 | |
*** bigdogstl has quit IRC | 12:23 | |
*** yamamoto has joined #openstack-doc | 12:26 | |
*** pcaruana has joined #openstack-doc | 12:33 | |
*** jpena is now known as jpena|lunch | 12:35 | |
*** bigdogstl has joined #openstack-doc | 12:38 | |
*** bigdogstl has quit IRC | 12:43 | |
*** bigdogstl has joined #openstack-doc | 12:52 | |
*** yangyapeng has quit IRC | 12:56 | |
*** strigazi has quit IRC | 12:56 | |
*** bigdogstl has quit IRC | 12:58 | |
*** strigazi has joined #openstack-doc | 13:04 | |
*** yangyapeng has joined #openstack-doc | 13:22 | |
*** bigdogstl has joined #openstack-doc | 13:23 | |
*** bigdogstl has quit IRC | 13:28 | |
*** yamamoto_ has joined #openstack-doc | 13:32 | |
*** rbowen has joined #openstack-doc | 13:33 | |
*** bigdogstl has joined #openstack-doc | 13:33 | |
openstackgerrit | Merged openstack/training-guides master: Imported Translations from Zanata https://review.openstack.org/534168 | 13:35 |
*** yamamoto_ has quit IRC | 13:35 | |
*** yamamoto has quit IRC | 13:35 | |
*** jpena|lunch is now known as jpena | 13:39 | |
*** tulivu has quit IRC | 13:40 | |
*** bigdogstl has quit IRC | 13:43 | |
*** tulivu has joined #openstack-doc | 13:46 | |
*** yamamoto has joined #openstack-doc | 13:47 | |
*** tulivu has quit IRC | 13:47 | |
*** tulivu_ has joined #openstack-doc | 13:47 | |
*** tulivu_ has quit IRC | 13:47 | |
*** tulivu has joined #openstack-doc | 13:47 | |
*** yamamoto has quit IRC | 13:52 | |
*** fragatina has joined #openstack-doc | 14:02 | |
*** fragatina has quit IRC | 14:02 | |
*** fragatina has joined #openstack-doc | 14:03 | |
*** mihalis68 has joined #openstack-doc | 14:06 | |
*** yamamoto has joined #openstack-doc | 14:17 | |
*** yamamoto has quit IRC | 14:22 | |
pkovar | AJaeger: 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 |
pkovar | sphinx-build would be consistent with https://governance.openstack.org/tc/reference/project-testing-interface.html#documentation | 14:51 |
stephenfin | pkovar: tox should call sphinx-build _and_ handle the nitty-gritty of building your environment. I'd use that, personally | 14:56 |
pkovar | good point, seems to be better suited for first time use case then | 14:56 |
* AJaeger agrees with stephenfin | 14:57 | |
pkovar | will have a patch ready shortly, will cc you folks | 14:57 |
pkovar | thanks | 14:57 |
*** emme has joined #openstack-doc | 15:00 | |
*** uberjay_ has quit IRC | 15:00 | |
*** yamamoto has joined #openstack-doc | 15:03 | |
*** yamamoto has quit IRC | 15:03 | |
*** uberjay has joined #openstack-doc | 15:04 | |
*** emme has quit IRC | 15:05 | |
*** uberjay has quit IRC | 15:06 | |
*** alexchadin has quit IRC | 15:07 | |
*** emme has joined #openstack-doc | 15:09 | |
*** yamamoto has joined #openstack-doc | 15:12 | |
*** bigdogstl has joined #openstack-doc | 15:13 | |
*** uberjay has joined #openstack-doc | 15:15 | |
*** yamamoto has quit IRC | 15:17 | |
pkovar | any suggestions as to how to collectively refer to docs repos such as security-doc and openstack-manuals? | 15:20 |
pkovar | would "documentation repos" be confusing? | 15:20 |
pkovar | "documentation repos as opposed to project repos" | 15:21 |
pkovar | not sure if that distinction is clear | 15:21 |
pkovar | but we kinda need it for doc contrib guide | 15:22 |
pkovar | right now its heavily openstack-manuals focused | 15:22 |
*** bigdogstl has quit IRC | 15:22 | |
pkovar | another tricky part is that e.g. security-doc tox environment is not really consistent with contributor-guide | 15:26 |
pkovar | hard to provide common docs for those! | 15:26 |
*** emme has quit IRC | 15:33 | |
*** emme has joined #openstack-doc | 15:34 | |
*** tulivu has quit IRC | 15:39 | |
dhellmann | pkovar : you're trying to talk about them collectively? if you give more context I might be able to help with phrasing. | 15:39 |
pkovar | dhellmann: basically, i'd like to separate this section https://docs.openstack.org/doc-contrib-guide/docs-builds.html#build-workflow | 15:40 |
pkovar | into project repos section | 15:40 |
pkovar | and "documentation repos" section | 15:41 |
pkovar | the former would talk about tox -e docs | 15:41 |
dhellmann | we could also add build instructions directly to the project repos in their contributor docs | 15:41 |
pkovar | the latter about what's there already | 15:41 |
dhellmann | the instructions that are there now only apply to the openstack-manuals repo, right? | 15:42 |
pkovar | correct, but wouldn't that need a lot of duplicated content? | 15:42 |
dhellmann | so you could talk about that repo specifically, and then "any other repositories" | 15:42 |
pkovar | yes, correct | 15:42 |
dhellmann | or even "all other repositories with documentation" | 15:42 |
pkovar | can we assume that a project repo is a repo with documentation? | 15:43 |
dhellmann | the 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 |
dhellmann | most project repos have docs; not all repos with docs are project repos | 15:43 |
*** fragatina has quit IRC | 15:43 | |
pkovar | well, then there are readme files that should in fact also contain the info | 15:43 |
pkovar | on building | 15:44 |
dhellmann | yes, at least a pointer in the repo to where the docs are published is a good idea | 15:44 |
*** fragatina has joined #openstack-doc | 15:44 | |
*** emme has quit IRC | 15:47 | |
pkovar | let 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 long | 15:49 |
*** bigdogstl has joined #openstack-doc | 15:50 | |
pkovar | for headings, etc. | 15:50 |
*** fragatina has quit IRC | 15:51 | |
*** fragatina has joined #openstack-doc | 15:51 | |
*** jamesmcarthur has joined #openstack-doc | 15:52 | |
pkovar | for 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 |
dhellmann | you could just say "other repositories" | 15:53 |
dhellmann | and clarify in the body of the text that not all of them will have documentation | 15:53 |
pkovar | or that | 15:55 |
AJaeger | pkovar, dhellmann: security-doc, api-site and openstack-manuals are all together in this IMHO | 15:55 |
dhellmann | AJaeger : why is security-doc not just using the regular sphinx build steps? | 15:56 |
dhellmann | I always forget about api-site, that one does need the special stuff | 15:56 |
pkovar | there are multiple docs in security-doc | 15:56 |
AJaeger | dhellmann: it has several documents | 15:56 |
dhellmann | sigh | 15:57 |
dhellmann | ok | 15:57 |
pkovar | ;) | 15:57 |
AJaeger | dhellmann: we could split that into several ones | 15:57 |
AJaeger | dhellmann: initially it was a docbook XML guide in security-doc as well... | 15:57 |
*** emme has joined #openstack-doc | 15:57 | |
*** yamamoto has joined #openstack-doc | 15:58 | |
*** emme has quit IRC | 16:00 | |
*** yamamoto has quit IRC | 16:01 | |
*** yamamoto has joined #openstack-doc | 16:01 | |
*** yamamoto has quit IRC | 16:01 | |
*** bigdogstl has quit IRC | 16:02 | |
*** mihalis68 has quit IRC | 16:26 | |
*** carl_baldwin has quit IRC | 16:32 | |
*** krtaylor has quit IRC | 16:36 | |
*** jpena is now known as jpena|off | 16:37 | |
pkovar | any 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-doc | 16:41 | |
*** jpena|off is now known as jpena | 16:41 | |
pkovar | but we kinda agreed on that at the ptg, but | 16:41 |
AJaeger | where do you want to add it? http://docs.openstack.org/project-team-guide/ | 16:43 |
AJaeger | pkovar: so, first merge it there - then remove from openstack-manuals. | 16:43 |
pkovar | i meant https://docs.openstack.org/infra/manual/ | 16:44 |
pkovar | but sounds good | 16:44 |
AJaeger | pkovar: ok, figure out what should go where, let it merge, then remove - that works fine for me... | 16:45 |
pkovar | man, the toc of https://docs.openstack.org/project-team-guide/ is looong | 16:45 |
*** yamamoto has quit IRC | 16:46 | |
dhellmann | pkovar : 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-doc | 16:46 | |
dhellmann | although it looks like the team guide already links over to the contributor guide | 16:46 |
dhellmann | ETOOMANYGUIDES | 16:46 |
pkovar | yes, it does | 16:47 |
*** bigdogstl has joined #openstack-doc | 16:47 | |
pkovar | yes, to much documentation ! | 16:47 |
pkovar | too, even | 16:47 |
dhellmann | explaining which jobs to configure sounds like an infra manual topic | 16:47 |
pkovar | yes | 16:47 |
dhellmann | is anything in https://docs.openstack.org/doc-contrib-guide/quickstart/developers.html still relevant? | 16:48 |
pkovar | i also found out i am much better at removing content than adding it! | 16:48 |
dhellmann | heh | 16:48 |
*** bigdogstl has quit IRC | 16:51 | |
*** emme has quit IRC | 16:52 | |
*** bigdogstl has joined #openstack-doc | 16:54 | |
*** bigdogstl has quit IRC | 16:59 | |
*** tesseract has quit IRC | 17:21 | |
*** bigdogstl has joined #openstack-doc | 17:28 | |
*** openstackgerrit has quit IRC | 17:33 | |
*** bigdogstl has quit IRC | 17:38 | |
*** yamamoto has joined #openstack-doc | 17:44 | |
*** fragatina has quit IRC | 17:49 | |
*** yamamoto has quit IRC | 17:58 | |
*** emme has joined #openstack-doc | 17:59 | |
*** bigdogstl has joined #openstack-doc | 18:06 | |
*** bigdogstl has quit IRC | 18:11 | |
*** bigdogstl has joined #openstack-doc | 18:19 | |
*** bigdogstl has quit IRC | 18:24 | |
*** bigdogstl has joined #openstack-doc | 18:26 | |
*** bigdogstl has quit IRC | 18:35 | |
*** openstackgerrit has joined #openstack-doc | 18:38 | |
openstackgerrit | Petr Kovar proposed openstack/openstack-manuals master: Update Building documentation and README https://review.openstack.org/534405 | 18:38 |
*** jpena is now known as jpena|off | 18:45 | |
openstackgerrit | Kendall Nelson proposed openstack/contributor-guide master: Add Task Tracking to Code&Docs https://review.openstack.org/528119 | 18:57 |
*** eumel8 has quit IRC | 18:58 | |
*** fragatina has joined #openstack-doc | 19:15 | |
*** pkovar has quit IRC | 19:25 | |
*** bigdogstl has joined #openstack-doc | 19:38 | |
*** bigdogstl has quit IRC | 19:48 | |
*** pcaruana has quit IRC | 19:50 | |
*** dustins has joined #openstack-doc | 19:53 | |
*** emme has quit IRC | 19:55 | |
*** bigdogstl has joined #openstack-doc | 20:09 | |
*** bigdogstl has quit IRC | 20:14 | |
*** bigdogstl has joined #openstack-doc | 20:28 | |
*** bigdogstl has quit IRC | 20:38 | |
*** bigdogstl has joined #openstack-doc | 21:15 | |
*** threestrands_ has joined #openstack-doc | 21:18 | |
*** bigdogstl has quit IRC | 21:45 | |
*** bigdogstl has joined #openstack-doc | 21:51 | |
*** rbowen has quit IRC | 22:02 | |
*** bigdogstl has quit IRC | 22:03 | |
*** bigdogstl has joined #openstack-doc | 22:05 | |
*** dustins has quit IRC | 22:18 | |
*** bigdogstl has quit IRC | 22:22 | |
*** rcernin has joined #openstack-doc | 22:31 | |
*** jamesmcarthur has quit IRC | 22:36 | |
*** jamesmcarthur has joined #openstack-doc | 22:43 | |
*** tpsilva has quit IRC | 22:54 | |
*** edmondsw has quit IRC | 22:55 | |
*** edmondsw has joined #openstack-doc | 22:56 | |
*** jamesmcarthur has quit IRC | 22:59 | |
*** edmondsw has quit IRC | 23:00 | |
*** bigdogstl has joined #openstack-doc | 23:00 | |
*** jamesmcarthur has joined #openstack-doc | 23:00 | |
*** bigdogstl has quit IRC | 23:08 | |
*** bigdogstl has joined #openstack-doc | 23:16 | |
*** bigdogstl has quit IRC | 23:22 | |
*** bigdogstl has joined #openstack-doc | 23:33 | |
*** charcol has joined #openstack-doc | 23:35 | |
*** suyog has joined #openstack-doc | 23:35 | |
*** bigdogstl has quit IRC | 23:45 | |
*** suyog has quit IRC | 23:53 | |
*** suyog has joined #openstack-doc | 23:58 |
Generated by irclog2html.py 2.15.3 by Marius Gedminas - find it at mg.pov.lt!