5 Dec 2025
arkiuat is it possible submit a PR as squashed using the web editor? I guess not. 14:51
Anyway, xt/rakudoc-types.rakutest is complaining about a link that I didn't even modify, in doc/Language/variables.rakudoc 14:52
# at xt/rakudoc-types.rakutest line 91\n # Failed test 'L<Regex|/language/regexes> should be L<C<Regex>|/type/Regex>'
/language/regexes is an actual article that was the intended link target there; arbitrarily forcing that to link to the type definition instead seems wrong 14:53
the link in question is in the discussion of The C<$/> variable on line 1175 of the .rakudoc 14:56
would the test be quieted if we didn't titlecase the linktext there? i. e. change "Regex" to "regex"? If so, that change seems worth making. 14:58
7 Dec 2025
Geth doc: arkiuat++ created pull request #4729:
per 4054 linked to next/last from while/until; moved return etc later
01:33
arkiuat well, duh. To answer my own question, I tried it out, and found that there are at least 3 occurrences of "L<Regex|/language/regexes>" in that document, none put there by me, but also that lower-casing the word "regex" does in fact satisfy the test that was complaining 03:10
[Coke] that test needs a skiplist for things that are class names but can safely point elsewhere. 14:06
I apologize, as I cannot find an issue or TODO comment reflecting this. 14:08
Please feel free to 1) ignore failures of that type for now (it's why that test is still in xt/ and not run on each commit), and if you could, please open a ticket and assign it to me.
Geth ¦ doc: arkiuat assigned to coke Issue xt/rakudoc-types.rakutest failing on valid links github.com/Raku/doc/issues/4730 16:13
arkiuat done, and thanks. No need for apologies! 16:14
I was running util/test-modified.sh -- is that the right one, or should I not be running the /xt tests? 16:16
oh no, I see you're telling me that I can safely ignore failed /xt tests. Gotcha.
I haven't submitted the PR that set that off yet, because it's for github.com/Raku/doc/issues/4318 which hasn't quite reached consensus and is currently assigned to @raiph and not me 16:19
[Coke] I have in the past assigned things to raiph because he tends to dump so much text on a ticket without giving a PR. 19:04
If you have a PR brewing for something assigned to him, just submit it, no worries from me.
arkiuat got it. 19:56
Geth ¦ doc: arkiuat self-assigned Docs on exceptions do not mention failures at all. github.com/Raku/doc/issues/3978 19:58
8 Dec 2025
¦ doc: arkiuat self-assigned Update heredoc discussion github.com/Raku/doc/issues/3972 01:55
[Coke] anyone interested in writing an advent post about... writing documentation? :) 20:39
I'll owe you a $beer and a commit bit.
Geth doc/arkiuat-heredoc-qq: 9eaef9cbbd | (Eric Forste)++ (committed using GitHub Web editor) | doc/Language/quoting.rakudoc
Revise variable interpolation explanation in quoting.rakudoc

Removed confusing extra verbiage from the explanation for variable interpolation in heredocs, and added a link to doc that more clearly explains what the removed verbiage was trying to explain.
21:05
doc: arkiuat++ created pull request #4731:
Revise variable interpolation explanation in quoting.rakudoc
21:06
¦ doc: arkiuat self-assigned Document the behavior of `try` and `$!` if no Exception is thrown github.com/Raku/doc/issues/4700 21:39
9 Dec 2025
doc/main: c1f7054dab | (Eric Forste)++ (committed using GitHub Web editor) | doc/Language/quoting.rakudoc
Revise variable interpolation explanation in quoting.rakudoc (#4731)

Removed confusing extra verbiage from the explanation for variable interpolation in heredocs, and added a link to doc that more clearly explains what the removed verbiage was trying to explain.
01:58
doc/main: 65058e7f46 | (Eric Forste)++ (committed using GitHub Web editor) | 2 files
remove method conj from Numeric per issue 3782 (#4725)

  * removing method conf from Numeric per discussion in issue 3782
  * make example for method conj more relevant to Cool
02:22
arkiuat Hmm, I guess a typical advent post is not all that long, huh 21:35
librasteve_ no indeed… 22:22
would welcome your help
10 Dec 2025
[Coke] arkiuat++ 01:45
Geth doc/main: 8b14d8bf6c | (Eric Forste)++ (committed using GitHub Web editor) | doc/Type/Rational.rakudoc
typo in doc for Rational.norm

s/by/be/ looks like typo influenced by varname in example code
21:07