*** noah has quit IRC | 01:08 | |
*** noah has joined #buildstream | 01:09 | |
*** noah has quit IRC | 01:12 | |
*** noah has joined #buildstream | 01:14 | |
*** mcatanzaro has joined #buildstream | 01:31 | |
*** mcatanzaro has quit IRC | 02:16 | |
*** tristan has quit IRC | 07:14 | |
*** tristan has joined #buildstream | 07:44 | |
*** ironfoot changes topic to "BuildStream 1.0.0 is out ! | https://gitlab.com/BuildStream/buildstream | Docs: https://buildstream.gitlab.io/buildstream | IRC logs: https://irclogs.baserock.org/buildstream | Roadmap: https://wiki.gnome.org/Projects/BuildStream/Roadmap" | 09:32 | |
gitlab-br-bot | buildstream: issue #178 ("Publish documentation for each stable branch + current development (master)") changed state ("opened") https://gitlab.com/BuildStream/buildstream/issues/178 | 09:36 |
---|---|---|
*** valentind has joined #buildstream | 09:44 | |
*** jonathanmaw has joined #buildstream | 09:48 | |
paulsherwood | w00t!!!! | 09:52 |
*** bethw has joined #buildstream | 09:53 | |
jonathanmaw | tristan: I've been put in charge of shepherding https://gitlab.com/BuildStream/buildstream/merge_requests/102. Was there anything in particular wrong with it? | 09:56 |
*** bochecha has joined #buildstream | 10:08 | |
*** ssam2 has joined #buildstream | 10:10 | |
*** valentind has quit IRC | 10:36 | |
gitlab-br-bot | buildstream: merge request (master->master: WIP: Documentation improvements) #183 changed state ("opened"): https://gitlab.com/BuildStream/buildstream/merge_requests/183 | 10:58 |
ssam2 | tristan, i agree about the wiki pages & roadmaps ... i'll rearrange them | 11:27 |
tristan | Oh... thanks a lot ssam2 :D | 11:30 |
ssam2 | ok, https://wiki.gnome.org/Projects/BuildStream/Roadmaps | 11:52 |
tristan | ssam2, Awesome :D | 11:54 |
tristan | some links will break to the older stuff, but this is better | 11:54 |
*** tpollard has joined #buildstream | 11:56 | |
ssam2 | any plan for how documentation will work now that we have released 1.0? | 12:26 |
ssam2 | or is that a task someone could look at? | 12:26 |
ssam2 | https://buildstream.gitlab.io/buildstream/ currently says "BuildStream 0.1 documentation" and is built from 'master' | 12:27 |
ssam2 | we should have https://buildstream.gitlab.io/buildstream/1.0/ and https://buildstream.gitlab.io/buildstream/unstable/ | 12:27 |
ssam2 | or something | 12:27 |
* nexus sobs | 12:29 | |
bochecha | ssam2: as well as a /stable/ or /latest/ redirect to /1.0/ (or a symlink) | 12:59 |
tristan | ssam2, filed this before you arrived this morning: https://gitlab.com/BuildStream/buildstream/issues/178 | 13:03 |
tristan | fwiw | 13:03 |
*** xjuan has joined #buildstream | 13:09 | |
*** xjuan has quit IRC | 13:11 | |
*** xjuan has joined #buildstream | 13:20 | |
*** noah has quit IRC | 13:20 | |
tristan | ssam2, yeah so anyway that is a problem that is unsolved, upstream gitlab bug report linked | 13:20 |
tristan | I'm not sure how to solve it :-S | 13:21 |
tristan | maybe there is the possibility of maintaining a list of branches in the .gitlab-ci.yml | 13:21 |
tristan | and then whenever the "only" filter (currently only master) is hit, we could have the pages docs generation job checkout each stable branch and generate docs in a loop ? | 13:22 |
tristan | like, build docs for each branch every time ? | 13:22 |
ssam2 | ouch, yes you'd think we wouldn't be the first to run into this | 13:57 |
ssam2 | to be honest i'm already not super happy with Gitlab Pages because of the stupid behaviour of https://buildstream.gitlab.io/ | 13:58 |
ssam2 | seems impossible to make that anything other than a 404 | 13:58 |
tristan | ssam2, it's possible to make a group wide page | 14:00 |
tristan | ssam2, just apparently, everyone has important stuff to do instead :) | 14:00 |
ssam2 | oh, i didn't even figure out how | 14:01 |
ironfoot | Readthedocs has support for multiple branches/releases. | 14:02 |
ironfoot | But then it won't be in gitlab pages | 14:03 |
*** tristan has quit IRC | 14:03 | |
*** tristan has joined #buildstream | 14:10 | |
tristan | ironfoot, the main advantage with pages is only that it's built into gitlab and we can automate it - however, whether it be readthedocs, or joe shmoe's http server, maybe doing a deploy to something external would be a good workaround | 14:13 |
tristan | i.e. if we can do an `scp` with some properly hidden ssh private key that only gitlab 'Masters' can see, from the gitlab job which publishes docs, that could be nice | 14:14 |
ssam2 | seems that readthedocs builds the docs themselves on their own server | 14:16 |
ssam2 | https://docs.readthedocs.io/en/latest/builds.html | 14:16 |
ssam2 | which might not work as we do special stuff before running sphinx | 14:16 |
tristan | yeah I certainly dont want to get into that | 14:17 |
tristan | I dont mind to change the location of docs to fix the issue, but buying into a whole new system to do so is yuck | 14:18 |
* tristan notices we have some kind of race in our tests | 14:19 | |
tristan | it looks like, some times a piece of code gets to run, which usually doesnt | 14:19 |
* persia is generally a fan of readthedocs for doc hosting, when the repo-hosting service isn't sufficient | 14:20 | |
tristan | looking at coverage reports for the last builds, most of them are 79.45%, while 2 of them are 79.53%, but with no significant code change related to tests | 14:20 |
tristan | persia, maybe there is a way to push built docs to readthedocs ? | 14:21 |
tristan | persia, what I dont like about it is fragmenting our infrastructure too much | 14:21 |
persia | tristan: Yep: you just need to have a key, which implies some secrets management tooling in the CD environment. | 14:21 |
tristan | just copying it to an http server seems just as good | 14:21 |
persia | Is there an appropriate http server already configured and ready for use? | 14:22 |
tristan | ah, so you dont *have* to build them there, so I think it's a reasonable alternative yeah | 14:22 |
persia | I like readthedocs mostly because someone else deals with the SLA | 14:22 |
tristan | gitlab does let you keep secrets and stuff so, should be doable... would be nice to stick with pages | 14:23 |
tristan | but eh, if it aint gonna be fixed soon... | 14:23 |
persia | I also prefer not to split infra, but if pages is too broken to be the default for docs, then ... | 14:23 |
tristan | persia, yeah I was just saying I'd prefer a raw http server to it, but only because I thought we'd have to buy into the rest of readthedocs too | 14:24 |
tristan | of course yeah... if it can be all gitlab, even better | 14:24 |
tristan | anyway... off to get some food | 14:24 |
gitlab-br-bot | buildstream: merge request (modAndTest->master: Making changes to various documents:) #206 changed state ("opened"): https://gitlab.com/BuildStream/buildstream/merge_requests/206 | 15:39 |
*** mcatanzaro has joined #buildstream | 16:38 | |
*** bethw has quit IRC | 17:47 | |
*** jonathanmaw has quit IRC | 18:05 | |
*** valentind has joined #buildstream | 18:10 | |
*** ssam2 has quit IRC | 18:27 | |
*** mbridon has joined #buildstream | 19:24 | |
*** mbridon is now known as mbridon1 | 19:25 | |
*** bochecha has quit IRC | 19:25 | |
*** mbridon1 is now known as bochecha | 19:26 | |
*** mcatanzaro has quit IRC | 19:58 | |
*** xjuan has quit IRC | 20:56 | |
*** mcatanzaro has joined #buildstream | 21:45 | |
*** valentind has quit IRC | 22:11 | |
*** tristan has quit IRC | 22:46 |
Generated by irclog2html.py 2.15.3 by Marius Gedminas - find it at mg.pov.lt!