| *** masaki has joined #openstack-doc | 00:02 | |
| *** suyog has joined #openstack-doc | 00:10 | |
| *** suyog has quit IRC | 00:10 | |
| *** suyog has joined #openstack-doc | 00:12 | |
| *** salv-orlando has quit IRC | 00:14 | |
| *** dmacpher has joined #openstack-doc | 01:08 | |
| *** salv-orlando has joined #openstack-doc | 01:15 | |
| *** larainema has joined #openstack-doc | 01:17 | |
| *** salv-orlando has quit IRC | 01:49 | |
| *** fragatin_ has quit IRC | 01:53 | |
| *** salv-orlando has joined #openstack-doc | 02:46 | |
| *** fragatina has joined #openstack-doc | 03:02 | |
| *** rcernin has quit IRC | 03:50 | |
| *** rcernin has joined #openstack-doc | 03:52 | |
| *** fragatin_ has joined #openstack-doc | 04:11 | |
| *** fragatina has quit IRC | 04:11 | |
| *** yamamoto has joined #openstack-doc | 04:21 | |
| *** yangyapeng has joined #openstack-doc | 04:26 | |
| *** fragatina has joined #openstack-doc | 04:56 | |
| *** fragatin_ has quit IRC | 04:58 | |
| *** masaki has quit IRC | 05:21 | |
| *** masaki has joined #openstack-doc | 05:22 | |
| *** d0ugal_ has joined #openstack-doc | 05:30 | |
| *** d0ugal has quit IRC | 05:32 | |
| *** rcernin has quit IRC | 05:38 | |
| *** threestrands has quit IRC | 06:03 | |
| *** gouthamr has quit IRC | 06:20 | |
| *** dnavale has quit IRC | 06:32 | |
| *** salv-orlando has quit IRC | 06:37 | |
| *** salv-orlando has joined #openstack-doc | 06:38 | |
| *** yamamoto has quit IRC | 06:47 | |
| *** gouthamr has joined #openstack-doc | 06:54 | |
| *** yamamoto has joined #openstack-doc | 06:56 | |
| *** suyog has quit IRC | 07:03 | |
| *** dmacpher has quit IRC | 07:15 | |
| *** charcol has quit IRC | 07:18 | |
| *** d0ugal_ has quit IRC | 07:31 | |
| *** AJaeger has quit IRC | 07:52 | |
| *** AJaeger has joined #openstack-doc | 07:56 | |
| *** eumel8 has joined #openstack-doc | 07:58 | |
| eumel8 | morning | 07:59 |
|---|---|---|
| *** pcaruana has joined #openstack-doc | 08:04 | |
| eumel8 | chason: alive? | 08:04 |
| *** alexchadin has joined #openstack-doc | 08:11 | |
| *** d0ugal_ has joined #openstack-doc | 08:13 | |
| *** alexchadin has quit IRC | 08:16 | |
| *** alexchadin has joined #openstack-doc | 08:17 | |
| *** alexchadin has quit IRC | 08:19 | |
| *** alexchadin has joined #openstack-doc | 08:19 | |
| *** gouthamr has quit IRC | 08:25 | |
| *** salv-orlando has quit IRC | 08:42 | |
| *** salv-orlando has joined #openstack-doc | 08:43 | |
| *** salv-orlando has quit IRC | 08:47 | |
| *** jpena|off is now known as jpena | 08:48 | |
| *** d0ugal_ has quit IRC | 08:53 | |
| *** d0ugal has joined #openstack-doc | 08:53 | |
| *** d0ugal has quit IRC | 08:53 | |
| *** d0ugal has joined #openstack-doc | 08:53 | |
| *** yamamoto has quit IRC | 08:54 | |
| *** salv-orlando has joined #openstack-doc | 08:58 | |
| *** masaki has quit IRC | 09:02 | |
| *** spectr has joined #openstack-doc | 09:07 | |
| *** spectr has quit IRC | 09:07 | |
| chason | eumel8 Hey o/ | 09:08 |
| *** spectr has joined #openstack-doc | 09:11 | |
| *** spectr has quit IRC | 09:12 | |
| eumel8 | hey chason :) | 09:18 |
| eumel8 | are you interested to takeover bug triage? https://wiki.openstack.org/wiki/Documentation/SpecialityTeams#Bug_Triage_Team | 09:19 |
| *** efoley has joined #openstack-doc | 09:20 | |
| *** yamamoto has joined #openstack-doc | 09:20 | |
| *** d0ugal has quit IRC | 09:24 | |
| *** d0ugal has joined #openstack-doc | 09:25 | |
| *** efoley has quit IRC | 09:34 | |
| *** efoley has joined #openstack-doc | 09:34 | |
| *** yamamoto has quit IRC | 09:36 | |
| *** yamamoto has joined #openstack-doc | 09:37 | |
| chason | eumel8 Why not? :) | 09:38 |
| *** yamamoto has quit IRC | 09:45 | |
| eumel8 | chason: thx, it's a quiet time. no much work :) | 10:03 |
| chason | eumel8 Yes, It is. | 10:03 |
| *** efoley has quit IRC | 10:03 | |
| *** tosky has joined #openstack-doc | 10:10 | |
| *** yamamoto has joined #openstack-doc | 10:17 | |
| *** efoley has joined #openstack-doc | 10:38 | |
| *** efoley has quit IRC | 10:44 | |
| *** efoley has joined #openstack-doc | 10:45 | |
| *** jpena is now known as jpena|off | 10:57 | |
| *** jpena|off is now known as jpena | 10:58 | |
| *** pkovar has joined #openstack-doc | 11:21 | |
| *** alexchadin has quit IRC | 11:28 | |
| *** openstackgerrit has quit IRC | 11:32 | |
| *** boden has joined #openstack-doc | 11:33 | |
| *** d0ugal has quit IRC | 11:51 | |
| *** d0ugal has joined #openstack-doc | 11:53 | |
| *** efoley_ has joined #openstack-doc | 12:32 | |
| *** efoley has quit IRC | 12:32 | |
| *** yamamoto has quit IRC | 12:39 | |
| *** jpena is now known as jpena|lunch | 12:50 | |
| *** salv-orlando has quit IRC | 12:59 | |
| *** salv-orlando has joined #openstack-doc | 13:00 | |
| *** yamamoto has joined #openstack-doc | 13:01 | |
| *** salv-orlando has quit IRC | 13:04 | |
| *** alexchadin has joined #openstack-doc | 13:13 | |
| *** yamamoto has quit IRC | 13:13 | |
| *** fragatina has quit IRC | 13:20 | |
| *** pblaho has joined #openstack-doc | 13:37 | |
| *** jpena|lunch is now known as jpena | 13:54 | |
| *** yangyapeng has quit IRC | 13:59 | |
| *** salv-orlando has joined #openstack-doc | 13:59 | |
| *** donghao has joined #openstack-doc | 14:05 | |
| *** yamamoto has joined #openstack-doc | 14:14 | |
| *** yamamoto has quit IRC | 14:20 | |
| *** yamamoto has joined #openstack-doc | 14:20 | |
| *** yangyapeng has joined #openstack-doc | 14:24 | |
| *** yangyapeng has quit IRC | 14:29 | |
| *** gouthamr has joined #openstack-doc | 14:32 | |
| *** alexchadin has quit IRC | 14:32 | |
| *** yangyapeng has joined #openstack-doc | 14:42 | |
| *** yangyapeng has quit IRC | 14:46 | |
| *** KeithMnemonic has joined #openstack-doc | 14:57 | |
| *** yangyapeng has joined #openstack-doc | 15:04 | |
| *** yangyapeng has quit IRC | 15:08 | |
| *** openstackgerrit has joined #openstack-doc | 15:20 | |
| openstackgerrit | Andreas Jaeger proposed openstack/openstackdocstheme master: DNM: Test releasenotes playbook https://review.openstack.org/520363 | 15:20 |
| *** d0ugal has quit IRC | 15:24 | |
| *** yangyapeng has joined #openstack-doc | 15:24 | |
| *** d0ugal has joined #openstack-doc | 15:27 | |
| *** yangyapeng has quit IRC | 15:28 | |
| *** efoley_ is now known as efoley | 15:40 | |
| *** edmondsw has joined #openstack-doc | 15:47 | |
| *** donghao has quit IRC | 15:58 | |
| *** yamamoto has quit IRC | 16:00 | |
| *** yamamoto has joined #openstack-doc | 16:06 | |
| *** yamamoto has quit IRC | 16:11 | |
| dhellmann | pkovar : you will likely want to watch this thread, and you may have input: http://lists.openstack.org/pipermail/openstack-dev/2017-November/124718.html | 16:35 |
| *** pcaruana has quit IRC | 16:35 | |
| *** yamamoto has joined #openstack-doc | 16:36 | |
| *** salv-orlando has quit IRC | 16:38 | |
| *** salv-orlando has joined #openstack-doc | 16:39 | |
| *** yamamoto has quit IRC | 16:41 | |
| *** jpena is now known as jpena|brb | 16:43 | |
| *** salv-orlando has quit IRC | 16:43 | |
| pkovar | dhellmann: thanks for the heads up | 16:47 |
| dhellmann | pkovar : there's also some discussion right now in #openstack-infra | 16:47 |
| pkovar | hmm, let me join then | 16:47 |
| dhellmann | pkovar : btw, we still don't have an owner for the steps after we recover the mitaka docs | 16:53 |
| pkovar | dhellmann: yeah, i'm ready to take it if no one else steps up | 16:54 |
| *** yamamoto has joined #openstack-doc | 17:05 | |
| *** yamamoto has quit IRC | 17:05 | |
| openstackgerrit | Merged openstack/openstack-manuals master: Removes unnecessary spaces on landing pages https://review.openstack.org/521203 | 17:06 |
| *** jpena|brb is now known as jpena | 17:26 | |
| *** edmondsw has quit IRC | 17:37 | |
| *** edmondsw has joined #openstack-doc | 17:38 | |
| *** fragatina has joined #openstack-doc | 17:39 | |
| *** salv-orlando has joined #openstack-doc | 17:39 | |
| *** edmondsw has quit IRC | 17:42 | |
| *** yangyapeng has joined #openstack-doc | 17:43 | |
| *** salv-orlando has quit IRC | 17:45 | |
| *** yangyapeng has quit IRC | 17:50 | |
| *** pcaruana has joined #openstack-doc | 18:00 | |
| *** yamamoto has joined #openstack-doc | 18:05 | |
| *** yamamoto has quit IRC | 18:11 | |
| *** yangyapeng has joined #openstack-doc | 18:12 | |
| *** yangyapeng has quit IRC | 18:17 | |
| *** jpena is now known as jpena|off | 18:20 | |
| *** yangyapeng has joined #openstack-doc | 18:31 | |
| *** yangyapeng has quit IRC | 18:34 | |
| *** tosky has quit IRC | 18:35 | |
| *** salv-orlando has joined #openstack-doc | 18:40 | |
| *** salv-orlando has quit IRC | 18:42 | |
| *** salv-orlando has joined #openstack-doc | 18:42 | |
| *** efoley has quit IRC | 18:47 | |
| *** efoley has joined #openstack-doc | 18:47 | |
| *** pkovar has quit IRC | 18:51 | |
| *** yangyapeng has joined #openstack-doc | 18:57 | |
| *** yangyapeng has quit IRC | 19:01 | |
| *** tosky has joined #openstack-doc | 19:13 | |
| *** yangyapeng has joined #openstack-doc | 19:15 | |
| *** yangyapeng has quit IRC | 19:20 | |
| *** efoley has quit IRC | 19:21 | |
| *** yangyapeng has joined #openstack-doc | 19:36 | |
| *** yangyapeng has quit IRC | 19:41 | |
| *** yangyapeng has joined #openstack-doc | 19:57 | |
| *** boden has quit IRC | 19:57 | |
| *** boden has joined #openstack-doc | 19:59 | |
| *** yangyapeng has quit IRC | 20:01 | |
| *** yangyapeng has joined #openstack-doc | 20:17 | |
| *** yangyapeng has quit IRC | 20:22 | |
| *** salv-orlando has quit IRC | 20:24 | |
| *** salv-orlando has joined #openstack-doc | 20:25 | |
| *** salv-orlando has quit IRC | 20:28 | |
| *** edmondsw has joined #openstack-doc | 20:29 | |
| *** edmondsw has quit IRC | 20:33 | |
| *** salv-orlando has joined #openstack-doc | 20:36 | |
| *** pcaruana has quit IRC | 20:39 | |
| *** yangyapeng has joined #openstack-doc | 20:41 | |
| *** yangyapeng has quit IRC | 20:45 | |
| *** krtaylor has quit IRC | 21:03 | |
| *** krtaylor has joined #openstack-doc | 21:16 | |
| *** eumel8 has quit IRC | 21:25 | |
| *** suyog has joined #openstack-doc | 21:33 | |
| *** dnavale has joined #openstack-doc | 21:33 | |
| *** linkmark has joined #openstack-doc | 21:45 | |
| *** rcernin has joined #openstack-doc | 21:48 | |
| *** mpranjic has quit IRC | 22:00 | |
| *** edmondsw has joined #openstack-doc | 22:17 | |
| *** edmondsw has quit IRC | 22:22 | |
| *** boden has quit IRC | 22:23 | |
| *** yangyapeng has joined #openstack-doc | 22:23 | |
| *** jamesmcarthur has joined #openstack-doc | 22:24 | |
| jamesmcarthur | Hi all. We are looking to add the new proposed sitemaps tool. Where under the docs repo should mguiney: submit that patch? | 22:27 |
| *** yangyapeng has quit IRC | 22:28 | |
| jamesmcarthur | dhellmann: ^^ | 22:28 |
| *** jamesmcarthur has quit IRC | 22:36 | |
| *** jamesmcarthur has joined #openstack-doc | 22:38 | |
| *** yangyapeng has joined #openstack-doc | 22:44 | |
| *** jamesmcarthur has quit IRC | 22:46 | |
| *** jamesmcarthur has joined #openstack-doc | 22:48 | |
| *** yangyapeng has quit IRC | 22:49 | |
| *** d0ugal has quit IRC | 22:50 | |
| dhellmann | jamesmcarthur : what does the tool look like and how does it work? | 22:53 |
| dhellmann | there are a few places it might live, and the best place depends on how it works | 22:54 |
| dhellmann | like it might go into its own repo as its own thing | 22:54 |
| dhellmann | or it could go into the theme | 22:54 |
| dhellmann | or even into the docs tools repo, I guess | 22:54 |
| dhellmann | mguiney : ^^ | 22:55 |
| jamesmcarthur | We were thinking docs tools. I'll let mguiney: explain how it's set up. | 22:56 |
| dhellmann | we probably want it to be pip-installable so that makes me lean towards somewhere other than docs tools, but let's see how it works first | 22:56 |
| mguiney | dhellmann: the idea was that easch sitemap is generated locally for each individual projects (largely because doing so in that manner has very little overhead) | 22:57 |
| dhellmann | if it's just a bash script or something we could probably put it right into project-config and run it as part of the job | 22:57 |
| jamesmcarthur | It's written in python | 22:57 |
| dhellmann | ok | 22:57 |
| mguiney | so each project has a sitemap, and these sitemaps are organized via an index in openstack docs | 22:57 |
| mguiney | both running on a cron so as to update automatically, sans need for a patch | 22:58 |
| dhellmann | hmm | 22:58 |
| dhellmann | under what conditions would the content of the site map change without a patch? | 22:58 |
| mguiney | dhellmann: the link grab was great in bash, the sitemap formatting was getting ugly fast | 22:58 |
| dhellmann | oh, yeah, no worries about using python for it | 22:58 |
| dhellmann | I was just curious about the idea of using something like cron | 22:59 |
| mguiney | the thought was to have it run any time a new doc was merged | 22:59 |
| dhellmann | yep, that part makes sense | 22:59 |
| mguiney | and update dynamically | 22:59 |
| dhellmann | does the script depend on anything outside of the python standard library? | 22:59 |
| mguiney | er lemme look (still finishing the per-project bit up) | 23:00 |
| mguiney | uses git, os, and requests | 23:00 |
| dhellmann | it uses git? | 23:00 |
| mguiney | git largely to grab the root of the project for better search scope | 23:01 |
| dhellmann | ah | 23:01 |
| dhellmann | ok, the job can pass that to it I think | 23:01 |
| mguiney | i can change it, that was just my initial solution to that problem | 23:01 |
| dhellmann | I guess what I was expecting was a tool that took as input a top level directory to scan for HTML files and that produced as output a sitemap file in that directory | 23:01 |
| mguiney | yep | 23:01 |
| mguiney | that is what the thing is | 23:02 |
| dhellmann | yeah, I'm just worried you're solving problems we don't hae :-) | 23:02 |
| dhellmann | have | 23:02 |
| dhellmann | zuul knows where all of the working directories are, so the tool doesn't have to figure that bit out | 23:02 |
| mguiney | ok so i think i may need a bit of scope clarification on this point | 23:02 |
| dhellmann | and if it's an argument to the script then we can use it in the regular docs jobs and in the release notes jobs | 23:02 |
| mguiney | oh ok, I can definitely just add the project root dir as an argument instead | 23:03 |
| dhellmann | yeah, the use of requests is also something we should talk about | 23:03 |
| mguiney | what is your thought on that? | 23:03 |
| dhellmann | what is the tool downloading with requests? | 23:03 |
| dhellmann | we probably should have had a conversation about how the doc jobs work before you got too far into it; I hope I'm not being discouraging at this point | 23:04 |
| dhellmann | :-( | 23:04 |
| mguiney | it's currently using requests to ensure that that particular page still exists | 23:04 |
| mguiney | ie does not 404 | 23:04 |
| dhellmann | aha, ok | 23:04 |
| mguiney | nah, i appreciate it | 23:04 |
| dhellmann | I suppose that makes sense during a cron run | 23:05 |
| dhellmann | I'm not sure we're going to want to use it from cron, though | 23:05 |
| mguiney | yerp. don't want any broken links | 23:05 |
| dhellmann | if we assume that this thing runs as part of the publishing job for docs in any project, like oslo.config | 23:05 |
| dhellmann | then when a patch lands in oslo.config we will run the job to build the docs and they will be written to a local directory private to the job | 23:06 |
| dhellmann | then this tool can run and it will find all of the files that are about to be published | 23:06 |
| dhellmann | it doesn't need to remember any old state information -- everything that will be published will be in a directory we can tell it | 23:06 |
| dhellmann | so it builds the map of that sub-tree by looking at the contents of the directory | 23:06 |
| dhellmann | and then it puts the file in the directory | 23:07 |
| mguiney | makes sense. so essentially just generate the new sitemap as a part of the patch build itself | 23:07 |
| dhellmann | and the *next* step in the process copies the whole thing up to the web server | 23:07 |
| dhellmann | using an rsync command that is smart enough to delete old files that don't exist in what is being copied up | 23:07 |
| *** d0ugal has joined #openstack-doc | 23:07 | |
| dhellmann | right | 23:07 |
| dhellmann | I guess based on that description the other thing the sitemap is likely to need to know is the top URL of whatever is being published, right? | 23:08 |
| dhellmann | I guess it depends on whether you're using the XML format or the plain file list format | 23:08 |
| mguiney | was planning on using xml, just because it is the existing format | 23:08 |
| dhellmann | works for me | 23:08 |
| dhellmann | so the *hard* parts of this are going to be in integrating it with the doc job(s) | 23:09 |
| dhellmann | well, not hard, but "not straightforward" | 23:09 |
| dhellmann | it'll be easy enough to plumb in the call, but the job doesn't necessarily know that URL value | 23:09 |
| dhellmann | I think we can derive it, though, based on information we do have like the project name and the branch name | 23:10 |
| dhellmann | do you know where those jobs are defined? if not, I can try to find it quickly so you have some time to look at it | 23:10 |
| mguiney | i'd currently just been using "docs.openstack.org/{projectname}/latest | 23:10 |
| mguiney | " | 23:10 |
| mguiney | i don't but can dig it up and look | 23:11 |
| dhellmann | where does the projectname value come from? | 23:11 |
| mguiney | currently? the root dir | 23:11 |
| mguiney | but that may not work. Was planning on finishing up the basic functionality, then adjusting | 23:11 |
| dhellmann | the template for the docs jobs is "publish-openstack-sphinx-docs" and that's defined in openstack-zuul-jobs/zuul.d/project-templates.yaml | 23:13 |
| dhellmann | that template refers to specific jobs | 23:13 |
| mguiney | thank you! | 23:13 |
| mguiney | also: if its part of the docs build process, i shouldnt neccessarily be checking link status | 23:13 |
| dhellmann | build-openstack-sphinx-docs is defined in zuul.d/jobs.yaml in the same directory | 23:14 |
| mguiney | because some of them won't exist yet. correct? | 23:14 |
| dhellmann | that's the job that needs the new step | 23:14 |
| * mguiney nods | 23:14 | |
| dhellmann | mguiney : exactly | 23:14 |
| dhellmann | no need to check link status | 23:14 |
| dhellmann | just build the sitemap using the files present in the directory | 23:14 |
| mguiney | I will likely push a WIP patch up with the basic script, and then work on the integration | 23:14 |
| dhellmann | that makes sense | 23:15 |
| mguiney | just for the sake of having the patch up | 23:15 |
| mguiney | cool! thank you, this has clarified things enormously | 23:15 |
| dhellmann | we need to think about where the script should live, based on how we're going to get it into the docs job | 23:15 |
| * mguiney nods | 23:15 | |
| dhellmann | for example, if we say that all the projects have to add it to their requirements list, we might put it into its own repo so we can publish it to pypi | 23:15 |
| * mguiney nods | 23:15 | |
| dhellmann | but that's a lot of work, to land that patch in every repo | 23:16 |
| dhellmann | since we know we want to run it as part of the job, always, we could also just put it in the job definition directly | 23:16 |
| dhellmann | I would need to consult with the infra team about the best way to do that | 23:16 |
| mguiney | that is another thing i was wondering about, given that it definitely would be pulling from an indvidual project to generate an individual project's sitemap | 23:16 |
| dhellmann | right, the context under which it is going to run is something to think about, too | 23:17 |
| mguiney | what do you mean? | 23:17 |
| dhellmann | it will be inside a job, on a CI node (not on the web server). It will have access to the project repo and tox and sphinx, but it doesn't *have* to be run under tox | 23:17 |
| mguiney | (just for clarity's sake?) | 23:17 |
| mguiney | ahhh makes sense | 23:17 |
| *** jamesmcarthur has quit IRC | 23:18 | |
| dhellmann | a lot of the "how to" for this changed when zuul v3 rolled out | 23:19 |
| dhellmann | so I'm hunting around looking for files to refer you to | 23:19 |
| mguiney | ahhh ok | 23:21 |
| dhellmann | mguiney : I *think* we would want to tie into the existing job in openstack-zuul-jobs/playbooks/sphinx-docs/run.yaml | 23:21 |
| *** yamamoto has joined #openstack-doc | 23:21 | |
| dhellmann | which is an ansible input file | 23:21 |
| mguiney | i'm just noting some of the things mentioned so I dont have to dig in longs | 23:21 |
| mguiney | *logs | 23:22 |
| mguiney | oooh ok | 23:22 |
| dhellmann | ++ | 23:22 |
| dhellmann | mordred : are you around? if I wanted to put a script somewhere so it ran as part of the build-openstack-sphinx-docs job but I didn't want to have to pip-install it into the tox environment, where could I put the file? can I use the "files" feature of an ansible playbook for that? | 23:23 |
| dhellmann | jeblair : ^^ | 23:23 |
| dhellmann | mguiney : we might have to wait until tomorrow for answers, given the time of day | 23:24 |
| *** d0ugal has quit IRC | 23:24 | |
| mguiney | makes sense | 23:24 |
| dhellmann | mguiney : it sounds like you have a little work you can do in the morning, though, to simplify the script you already have? | 23:25 |
| mguiney | in the meantime though, i definitely have lots to go on so that I can get a WIP patch up | 23:25 |
| dhellmann | cool | 23:25 |
| mguiney | though... where was the agreed upon location, again? | 23:25 |
| dhellmann | well, that's the thing :-) | 23:25 |
| mordred | dhellmann: heya - reading real quick | 23:25 |
| dhellmann | aha, let's see | 23:25 |
| dhellmann | mordred : I just realized another option would be to have that job depend on whatever repo contains the script, but that feels a little icky | 23:26 |
| mordred | dhellmann: yes - you can just copy a file over with the playbook | 23:26 |
| dhellmann | do you have an example of that mguiney can use to work from? | 23:26 |
| mordred | I do - one sec | 23:26 |
| mguiney | ty! | 23:26 |
| mordred | although- lemme read more backscroll real quick as I've got a bunch of patches up that change how the docs build jobs work :) | 23:27 |
| dhellmann | heh | 23:27 |
| mordred | mguiney: at the very least, you'll want to start with https://review.openstack.org/#/c/521145/ and build whatever on top of it, rather than starting from what's in the tree right now | 23:28 |
| mguiney | ty | 23:30 |
| mguiney | can do | 23:30 |
| mordred | mguiney, dhellmann: so - summarizing what I understand from the scrollback, the goal is to add the generation of a sitemap as part of doc builds? | 23:35 |
| mguiney | yep | 23:35 |
| dhellmann | mordred : yes | 23:35 |
| mguiney | (and thus avoid the massive full domain crawl and manual patch process required for generation of a new sitemap) | 23:36 |
| *** linkmark has quit IRC | 23:38 | |
| mordred | gotcha. so yah - I agree with all the above - sounds like a thing that wants to just go into the job (since running it outside of the context of our doc publication pipeline doesn't make much sense) ... | 23:38 |
| dhellmann | as with whereto, though, I'm not sure it makes sense to put it into zuul-jobs | 23:39 |
| dhellmann | it feels like an openstack-zuul-jobs thing | 23:39 |
| mordred | do we need to run this on all of the various types of docs we're building and publishing? (like, api-ref, releasenotes, developer docs) | 23:39 |
| dhellmann | it won't hurt to run it everywhere | 23:39 |
| * jeblair is lurking | 23:39 | |
| dhellmann | it would be good to be able to do it | 23:39 |
| dhellmann | the priority is for project docs | 23:39 |
| dhellmann | we can link to all of them from the main docs.o.o build though | 23:40 |
| mordred | gotcha. so yah - a post-playbook on build-openstack-sphinx-docs seems like the right place to stick it, and it it's done as its own role, then it would be easy enough to add it to other places as needed | 23:40 |
| dhellmann | ok. I'm not 100% sure what is needed to set all of that up | 23:41 |
| dhellmann | is a post playbook going to run before the files are synced to the web server? | 23:41 |
| mordred | dhellmann: yes - the post playbooks for build-openstack-sphinx-docs will run after docs have been built but before the parent job copies the output for publication | 23:43 |
| dhellmann | cool | 23:43 |
| dhellmann | mguiney : so, this is our answer as far as where the new file goes: in a role, in openstack-zuul-jobs | 23:43 |
| dhellmann | I can help work out the specific details tomorrow, but it's dinner time here now | 23:44 |
| jeblair | https://docs.openstack.org/infra/manual/zuulv3.html#job-inheritance has an illustration of the nested nature of post playbooks, if that helps | 23:44 |
| jeblair | (see the grey box example) | 23:44 |
| dhellmann | jeblair : cool, thanks | 23:44 |
| dhellmann | mguiney : I think we have some time, since we need mordred's patches to land, too | 23:45 |
| * mguiney nods | 23:46 | |
| dhellmann | ok, I'm dropping offline for food, have a good evening! | 23:47 |
| mguiney | have a good one, thanks for all the input | 23:48 |
| mordred | mguiney: let me know, as you start poking at it, if you need help | 23:48 |
| *** gfhellma has joined #openstack-doc | 23:49 | |
| mguiney | can do! | 23:49 |
| mguiney | thank y'all for the pointers, looks like i have lots to do :) | 23:52 |
Generated by irclog2html.py 2.15.3 by Marius Gedminas - find it at mg.pov.lt!