Documentation Channel for #raku | This channel is logged | Roadmap: github.com/raku/doc/wiki
Set by [Coke] on 23 May 2022.
03:03 rf left
lizmat realizes her mental capacity is only good enough for documentation of simple stuff today 08:20
aka day 2 of being Covid positive :-( 08:22
Geth doc/main: 4143d9fa59 | (Elizabeth Mattijsen)++ | doc/Type/VM.rakudoc
Document VM.request-garbage-collection
08:28
doc/main: 93cd33b117 | (Elizabeth Mattijsen)++ | doc/Type/Attribute.rakudoc
Date the "is built" trait
08:47
doc/main: 6b53044b76 | (Elizabeth Mattijsen)++ | doc/Programs/03-environment-variables.rakudoc
Elaborate on RAKU_EXCEPTIONS_HANDLER

  - Date it correctly
  - Mention PERL6_EXCEPTIONS_HANDLER's existence and removal
09:00
doc/main: 2fa33bf3b2 | (Elizabeth Mattijsen)++ | doc/Type/Str.rakudoc
Date Str.comb(Regex, :match)
09:03
09:22 kjp joined 14:00 rf joined
[Coke] the docs now have multi sub rotor(*@cycle, \source, Bool() :$partial --> Seq:D) 16:24
but this isn't valid in rakudo ATM. the source says "# We have to emulate :(*@ [@list, \tail]) because the grammar wont cut it." 16:25
lizmat well, the actual sig is **@foo I believe
[Coke] I can see an argument of showing it either way, but if we keep this, we have to not test this sub's sig.
so the other option is to do the same cheat as rakudo and perhaps document the cheat.
lizmat and that doesn't tell anybody anything, I'd say
[Coke] OK, will make the compilation test pass (with a skip), and add a comment (not user facing) about the sig diff. 16:26
Geth doc/main: 199518de57 | (Will Coleda)++ | doc/Type/List.rakudoc
Pass examples compilation

The syntax shown here is expressive, but not technically legal. Leaving it for pedagogical reasons.
16:30
doc/main: bd64a31b31 | (Will Coleda)++ | xt/pws/words.pws
new word
[Coke] Thanks again everyone for getting us moving again on docs! 16:31
down to 433 open tickets on raku/doc 16:45
coleman: removing github.com/Raku/doc/wiki/Production-Environment which was only a placeholder so far, assuming this will really go in the Infra docs 17:12
coleman THat's good 17:18
Thank you for the heads up
[Coke] added a side bar to the wiki so we now must organize it manually. 17:28
but now we can push old stuff down into "archive" without obsucuring recent stuff.
coleman good iea
*idea