Documentation Channel for #raku | This channel is logged | Roadmap: github.com/raku/doc/wiki
Set by [Coke] on 23 May 2022.
02:58 rf left
Geth doc/main: 1d11030921 | (Elizabeth Mattijsen)++ | doc/Type/DateTime.rakudoc
Document DateTime.posix(:real)
13:01
doc/main: b3e0c1d99f | (Elizabeth Mattijsen)++ | 2 files
Document Exception|Cool.Failure coercer
13:07
13:21 rf joined
[Coke] \o/ 14:08
Geth doc/main: 92686de1bd | (Elizabeth Mattijsen)++ | 2 files
Document ThreadPoolScheduler.new(:max_threads) a bit better

And the associated RAKUDO_MAX_THREADS environment variable.
14:45
doc/main: 438708cd09 | cfa++ | doc/Type/DateTime.rakudoc
Fix signature typo
15:02
doc/main: bd8282ece8 | cfa++ | doc/Type/ThreadPoolScheduler.rakudoc
Add code preamble
15:11
doc/main: 8fd5f52b1a | (Elizabeth Mattijsen)++ | doc/Type/ThreadPoolScheduler.rakudoc
Change pseudocode into actual code

Now not needing the preamble
15:14
doc: cfa++ created pull request #4259:
Amend documented signatures for `Failure` methods
15:18
doc/main: ec0bc09b51 | cfa++ (committed using GitHub Web editor) | 2 files
Amend documented signatures for Failure methods (#4259)
15:23
doc/main: 57206323e1 | (Elizabeth Mattijsen)++ | doc/Type/IO/Path.rakudoc
Document IO::Path.dir-with-entries
15:32
lizmat meh, looks like the REPL is not a lemma 15:42
Geth doc/main: ef66f20a7b | (Elizabeth Mattijsen)++ | doc/Programs/03-environment-variables.rakudoc
Document support for INSIDE_EMACS environment variable
15:47
doc/main: 52c2ea05e7 | (Elizabeth Mattijsen)++ | doc/Type/List.rakudoc
Document roundrobin( ..., :slip)
16:31
doc/main: 08b4ee46c5 | (Elizabeth Mattijsen)++ | doc/Type/Cool.rakudoc
DOcument Cool.Order
16:35
doc/main: 33a6b17f1f | (Elizabeth Mattijsen)++ | doc/Language/variables.rakudoc
Bring version statement more in line with others
16:41
doc/main: 9d53594e5f | (Elizabeth Mattijsen)++ | doc/Programs/03-environment-variables.rakudoc
Document RAKUDO_OPT for now
17:02
doc/main: 3db8263a4e | cfa++ | doc/Type/List.rakudoc
Normalise link (remove ".html")
17:10
lizmat oops, copy pasto cfa++ 17:18
interesting: there is no documentation about IterationBuffer, nor is there any test in roast (other then checking the existence of the classe) 18:37
so: does that mean it's an implementation detail or not? 18:38
note that the class is *not* marked as an implementation-detail
I'm leaning towards documenting and testing in roast 18:39
Geth doc/main: 1e8ea8a48a | (Elizabeth Mattijsen)++ | doc/Programs/03-environment-variables.rakudoc
Document RAKUDO_PRECOMPILATION_PROGRESS
18:55
doc/main: a327de2e7d | (Elizabeth Mattijsen)++ | doc/Type/DateTime.rakudoc
Mark availability of DateTime.Numeric
18:57
doc/main: 03a7c1dd7a | (Elizabeth Mattijsen)++ | doc/Type/IO/Path.rakudoc
Document IO::Path.add(<bar baz>)
19:02
[Coke] doing both is great. If we have items that are unspecc'd at some point we probably want to say it's not specced so people don;'t rely on it. hardline: don't document unspecced items: friendly: doc but warn. 19:05
so many commits to review, thank you! 19:06
lizmat yw :-) 19:07
[Coke] once I do a review pass we'll push to prod by tomorrow, lots of updates here. 19:08
Geth ¦ doc: coke self-assigned xt test for missing C in C<> (and let's use a allow-list for doc text) github.com/Raku/doc/issues/2306 19:10
doc/main: e2eb0f28c5 | (Will Coleda)++ (committed using GitHub Web editor) | 20 files
Add test for <> (missing formatcode) (#4257)

  * Add test for <> (missing formatcode)
  * Fixup some missing C<> in pod.
19:12
doc/main: 9f10710a53 | (Elizabeth Mattijsen)++ | doc/Language/control.rakudoc
Document next/last with a value in 6.e
19:20
doc/main: 63ca40c6b0 | (Elizabeth Mattijsen)++ | doc/Type/List.rakudoc
Document .pick(**)
19:28
[Coke] lizmat: github.com/Raku/doc/commit/9f10710...f510a00dcf says you can use last in a map but then shows an example with next. 20:04
... ah, that's a simple typo, there's a section below with next. no worries.
.... I did it here: section below with *last*. :) 20:09
/win 11 20:25
lizmat: the pick(**) - compilation test is failing on that method and I can't find it in the source- is it really Callable? 20:26
I think it is. 20:32
Geth doc/main: 094c08a618 | (Will Coleda)++ | doc/Programs/03-environment-variables.rakudoc
typo,specify lang
20:38
doc/main: 7904706d86 | (Will Coleda)++ | doc/Type/List.rakudoc
fix signature.
doc/main: dfb3dd27d2 | (Will Coleda)++ | xt/pws/words.pws
new word
20:49 NemokoschKiwi joined 20:52 NemokoschKiwi left
Geth doc/main: 7258d52c0c | (Will Coleda)++ | 3 files
Remove old util

Use xt/check-signatures.rakutest instead.
Closes #4223
20:54
¦ doc: coke unassigned from codesections Issue util/list-missing-methods failure github.com/Raku/doc/issues/4223 20:55
¦ doc: coke self-assigned Check for indexing marks that try to index the page they're in github.com/Raku/doc/issues/4057