| -@gerrit:opendev.org- Dong Zhang proposed: [zuul/zuul] 819557: Report total duration when a build set is finished https://review.opendev.org/c/zuul/zuul/+/819557 | 04:34 | |
| -@gerrit:opendev.org- Matthieu Huin https://matrix.to/#/@mhuin:matrix.org proposed: [zuul/zuul] 820541: GUI - Use indices in searches https://review.opendev.org/c/zuul/zuul/+/820541 | 15:40 | |
| -@gerrit:opendev.org- James E. Blair https://matrix.to/#/@jim:acmegating.com proposed: [zuul/zuul] 820585: WIP: Reorganize docs https://review.opendev.org/c/zuul/zuul/+/820585 | 19:49 | |
| @jim:acmegating.com | zuul-maint: would you please speedy-approve https://review.opendev.org/820587 -- "Pin mistune" -- that's needed to fix doc builds on master | 19:57 |
|---|---|---|
| @clarkb:matrix.org | I went ahead and approved it since it is a straightforward doc only update | 20:00 |
| -@gerrit:opendev.org- James E. Blair https://matrix.to/#/@jim:acmegating.com proposed: [zuul/zuul] 820593: Add a version selector to docs https://review.opendev.org/c/zuul/zuul/+/820593 | 21:31 | |
| @jim:acmegating.com | tristanCClark fungi over the weekend i got inspired to try a docs reorg -- i think it builds on what we've learned and hopefully makes things a little easier to find. if you have a minute to look at https://zuul.opendev.org/t/zuul/build/f883583c4bd248149fd2a3afabd17024/artifacts i'd appreciate it | 21:34 |
| @jim:acmegating.com | basically, i'm looking for feedback on the structure, and if you like it, i'll finish it up. | 21:35 |
| @clarkb:matrix.org | I pulled up the change itself to get a sense of the delta and now I see why you linked to the artifacts :) no worries, to be expected with this sort of change | 21:36 |
| @jim:acmegating.com | yeah. there *are* some wording changes, but i tried to keep it minimal. the biggest thing is there's a new 'about' page. i would say the other wording changes are pretty insubstantial. but a bit of splitting pages up or re-combining them. | 21:37 |
| @clarkb:matrix.org | corvus: I left some comments about things I noticed. Overall I like it. In particular having the navigation tree there makes a huge difference. Now if you click on a link you still know where you are and can find it later | 21:51 |
| @jim:acmegating.com | Clark: thanks! | 21:58 |
| @jim:acmegating.com | if we like using the rtd theme, i think we can get rtd-style version selection with this followup: https://review.opendev.org/820593 | 22:01 |
| @clarkb:matrix.org | I think the alabastor theme works better if you expect readers to always start at the beginning and go as far as they want by clicking next as makes sense | 22:04 |
| @clarkb:matrix.org | for python requests for example this works well | 22:04 |
| @clarkb:matrix.org | but for something like Zuul where there are multiple angles to approach needing documentation the tree is important imo | 22:05 |
| @jim:acmegating.com | yeah. i'd actually like the expansion to work a little differently, so if you expand one top level item, the others stay expanded. then it's even easier to explore the hierarchy. that worked in one test setup i did locally, but not in the current change. i dunno what was different. :| | 22:07 |
| @jim:acmegating.com | (i suspect it has something to do with distinct toctrees or something like that) | 22:07 |
| @jim:acmegating.com | i'm also struggling a bit with what to call "the stuff you put in zuul.yaml"; i've got it as "Project Configuration" but i feel like that's still too obtuse... "Zuul Configuration" isn't specific enough in a doc that also has main.yaml and zuul.conf. maybe we should just call the section "zuul.yaml" ... | 22:09 |
| @jim:acmegating.com | oh, or maybe "Job Configuration" to go along with "Job Content"... | 22:10 |
| @jim:acmegating.com | i also looked at gerrit's docs too... i took some organizational cues from there | 22:12 |
| -@gerrit:opendev.org- Zuul merged on behalf of James E. Blair https://matrix.to/#/@jim:acmegating.com: [zuul/zuul] 820587: Pin mistune https://review.opendev.org/c/zuul/zuul/+/820587 | 22:44 | |
| -@gerrit:opendev.org- James E. Blair https://matrix.to/#/@jim:acmegating.com proposed: [zuul/zuul] 820608: Quantize relative priority https://review.opendev.org/c/zuul/zuul/+/820608 | 22:53 | |
| -@gerrit:opendev.org- James E. Blair https://matrix.to/#/@jim:acmegating.com proposed: [zuul/zuul] 817640: Add some pipeline processing stats https://review.opendev.org/c/zuul/zuul/+/817640 | 23:47 | |
| -@gerrit:opendev.org- Zuul merged on behalf of James E. Blair https://matrix.to/#/@jim:acmegating.com: [zuul/zuul] 820413: Move relevant change expansion to change cache cleanup https://review.opendev.org/c/zuul/zuul/+/820413 | 23:57 | |
Generated by irclog2html.py 2.17.2 by Marius Gedminas - find it at https://mg.pov.lt/irclog2html/!