Documentation Channel for #raku | This channel is logged | Roadmap: github.com/raku/doc/wiki
Set by [Coke] on 23 May 2022.
00:08 rf joined 02:04 gfldex left 02:06 gfldex joined 03:25 rf left 07:52 sena_kun joined 09:31 sena_kun left
[Coke] . 12:25
lizmat: I don't know if it's helpful, but if you run make xtest with rakudo HEAD, buried in there is a small list of AST classes that still need docs. :) 12:26
I figure you've been reducing that list already. I've been trying to clean up some of the example failures. I think the next "tricky" one is that we don't like leading whitespace, but there are some examples with POD *inside* the code that is indented, not sure if that indent is required to avoid processing as the pod from the main file. 12:28
Thanks for getting these in there, appreciate it!
afk
lizmat Coke: there are *many*, **many** classes that need docs... 12:32
at least 450 more
[Coke] ... then the test isn't picking those up. :) 13:20
lizmat because they're not mentioned anywhere yet ? 13:21
and/or the test is not using "use v6.e.PREVIEW" or "use experimental :rakuast" ?
[Coke] ah, yes, I thought it was checking source, it's checking docs. so doc/Type/RakuAST/Doc.rakudoc mentions StatementList and VarDeclaration/Simple 13:22
and so two failures in rakudoc-l. No worries, that'll get sorted out as we go.
lizmat yup
tbrowder__ have the current public docs been rebuilt recently? the reason i ask is i haven’t seen a change from my 13:57
*expected chg from my merged PR
and following web edit 13:58
[Coke] i don't think anyone pressed the publish button. can you verify that docs-dev has your change? 14:41
if so, I'll press the button next time I have a gap between calls
tbrowder__ i’ll have to ck later, thnx 15:33
[Coke] coleman: looks like docs-dev is down? 16:47
Geth doc/main: 21f29c22e9 | (Will Coleda)++ | doc/Type/RakuAST/Doc/Block.rakudoc
whitespace
16:54
doc/main: 7be6e32123 | (Will Coleda)++ | doc/Type/RakuAST/Doc/Markup.rakudoc
pass example copilation tests
doc/main: b49694dc4c | (Will Coleda)++ | doc/Type/RakuAST/Doc/DeclaratorTarget.rakudoc
pass example compilation tests
16:56
coleman looking into it 16:57
it's weird. The port is open, the container is up, the container's logging. 17:06
continuing to look 17:07
lizmat URL?
coleman docs-dev.raku.org 17:18
lizmat error code 521
:-(
some kind of config issue on Cloudflare? pointing to the wrong IP? any requests being logged ? 17:19
coleman I don't think it's external networking
a curl on localhost hangs. it could be a messed up container pull 17:20
lizmat so in issue inside Cloudflare you mean? Or is it DNS? It's always DNS
coleman I don't think so... 17:23
rebooting the box now
What's strange is the image works fine: podman run -p 8080:80 quay.io/colemanx/raku-doc-website:latest 17:24
So I suspect local corruption of the image. 17:25
But that's kind of a wild guess
lizmat that would be... icky? 17:27
coleman I think we're back 17:28
[Coke] last failures of examples compilation are the "=table" entries.
(dev) I see it
coleman I have never seen that before. I really do think it was a corrupt storage for podman.
Geth doc/main: 86ca49ab54 | (Will Coleda)++ | doc/Type/RakuAST/Doc/Declarator.rakudoc
pass example compilation tests
17:29
coleman The remedy is a root command: `podman system reset`
we ran out of disk space yesterday, so it does feel like something that could have been fallout from that 17:30
[Coke] tbrowder__: docs-dev.raku.org/language/unicode_ascii now says "whitespace whitespace characters" on the section heading.
17:48 sena_kun joined
tbrowder__ yeah, not what intended. i’ll take out the web edit i made 19:14
Geth doc/main: c1227a32ca | (Tom Browder)++ (committed using GitHub Web editor) | doc/Language/unicode_ascii.rakudoc
Update unicode_ascii.rakudoc

Undo my last web editor commit. It did not produce the effect I expected.
19:55
[Coke] checked, no change yet on -dev 20:02
Geth doc/main: 5c9165ff05 | (Will Coleda)++ | doc/Language/variables.rakudoc
whitespace
20:11
doc/main: ba8457593b | (Will Coleda)++ | xt/examples-compilation.rakutest
Add extra newline before closing }

Otherwise some tests for POD constructs get crowded and fail to compile
20:15
[Coke] ls 20:48
ww
sjn ls: cannot open directory '.': Permission denied 20:50
lizmat coleman: seems docs-dev is down again? 20:56
coleman what the devil 21:17
I did not intervene but it seems to be back online 21:18
apologies
lizmat not for me 21:19
coleman the https is up, but http is down docs-dev.raku.org/ ? 21:22
lizmat aaaah... I guess my IRC client assumes http:// if there is no scheme 21:24
good catch.... but perhaps there should be a redirect on port 80 to send to https:// ??
coleman I've opened 80 on the load balancer 21:25
lizmat there's no way to tell the load balancer to redirect :80 to :443 ? 21:28
coleman Production does a redirect to https
lizmat ah, ok, then please disregard my comments and sorry for the noise :-)
afk&
coleman not at all; I myself forgot 21:29
22:19 sena_kun left
[Coke] coleman: can I force a new build of docs-dev here: buildkite.com/raku/doc-website 23:02
?
(vs. -prod for the prod site)
ah, no, my notes say the build is done elsewhere... but the notes don't say where. 23:03
coleman you can 23:04
the dev site is updated by cron
ah but you can't speed up the interval from there, no 23:05
the next run is in 22 min 23:07
[Coke] how frequently does it go? 23:13
opened some tickets on Collections because it fails on case-insensitive file systems. 23:14
coleman every 30 min is the systemd timer interval 23:16
OnCalendar=*:0/30 to be precise 23:18
[Coke] doc-website url at buildkite says last build was 2:07pm (times there in... utc?) 23:23
coleman not sure, actually 23:24
the CI container runs in Frankfurt
docs-dev.raku.org/about 23:26
buildkite.com/raku/doc-website/set...dd3fa8c0d2 23:30
We're in a lull
in the scheduled builds 23:31