Documentation Channel for #raku | This channel is logged | Roadmap: github.com/raku/doc/wiki
Set by [Coke] on 23 May 2022.
Geth doc/type-links: f1b9f67bc6 | (Will Coleda)++ | xt/rakudoc-types.rakutest
ignore X<> markers.
 00:11
doc/type-links: fbe58443c6 | (Will Coleda)++ | xt/rakudoc-types.rakutest
Only report exact case matches.

Be sneaky and work even on case-insensitive file systems.		 00:27
[Coke] cfa, hopefully that address two of your 3 points. 00:28
That's now at 3345 individual cases. 00:30
Geth doc: cfa++ created pull request #4262:
Remove formatting codes from various examples		 02:08
¦ doc: cfa self-assigned Leaky, nested tags in the $*REPO section github.com/Raku/doc/issues/4261 02:23
doc/main: 8898dc5c8e | cfa++ | doc/Language/compilation.rakudoc
Fix C<B<...>> markup/formatting error

Closes #4261.		 02:28
coleman [Coke]: I'm okay skipping it 02:44
03:53 Guest35 left 04:00 rf left 10:27 Geth left, Geth joined
Geth doc/main: 7f9b27debd | (Elizabeth Mattijsen)++ | doc/Type/IterationBuffer.rakudoc
Tweak IterationBuffer documentation a bit

After having written tests, I noticed some properties were missing		 11:16
doc/main: d0ac898f51 | (Elizabeth Mattijsen)++ | doc/Type/List.rakudoc
Document sub rotor
 11:32
doc/main: 261e2a1830 | (Elizabeth Mattijsen)++ | doc/Type/IterationBuffer.rakudoc
Date some IterationBuffer features
 11:35
doc/main: e3ec1efeda | (Elizabeth Mattijsen)++ | doc/Type/Telemetry.rakudoc
Document safe-snapper module
 11:47
doc/main: 71391b1cb3 | (Elizabeth Mattijsen)++ | doc/Type/Cool.rakudoc
Document Cool.uniparse
 11:55
doc/main: 16258ab187 | (Elizabeth Mattijsen)++ | doc/Language/traits.rakudoc
Document class|role is implementation-detail
 12:06
doc/main: ceb58f25d7 | (Elizabeth Mattijsen)++ | doc/Type/QuantHash.rakudoc
Document QuantHash.Map
 12:07
12:10 Geth left, Geth joined
Geth doc/main: bfa8305a05 | (Elizabeth Mattijsen)++ | 2 files
Document Any|Seq.slice
 12:19
doc/main: df826546dc | (Elizabeth Mattijsen)++ | doc/Language/create-cli.rakudoc
Document %*SUB-MAIN-OPTS<coerce-allomorphs-to>
 12:39
doc/main: 6ca70da1f6 | (Elizabeth Mattijsen)++ | 2 files
Document spurt without data
 12:50
doc/main: 4aea97f4e1 | (Elizabeth Mattijsen)++ | doc/Language/setbagmix.rakudoc
Date the (==) operator

Also mention raku.land/zef:lizmat/Set::Equality as an alternative		 13:01
[Coke] updated Raku/rakudoc to just send here, not #raku 13:07
lizmat :-) yeah I was spamming #raku a bit I guess 13:08
[Coke] I just had it redeliver a PR assignment, didn't show up 13:09
we get ticket assignments, right? do we get PRs?
Looks like rakudoc maybe used to support 'rakudoc Str' or 'Rakudoc Str.chars' but now you have to use 'rakudoc Type/Str' to basically look at the file. 13:11
Any lurkers want to take that on, let me know. :) 13:13
we also need a release to get a version out there that doesn't spew deprecation warnings. 13:14
lizmat: should I mark all the checklist tickets in the current milestone? 13:16
(expected to be completed by the end of the month?)
lizmat yes, that should be doable
[Coke] WOOT
13:21 rf joined
[Coke] put them all into Q1, closed all the tickets where the checklists were done and there were no questions in the thread. 13:23
last commit on rakudoc before my deprecation fix was in 2021, guessing we've lost the original authors. 16:04
Geth rakudoc/main: f33f096704 | Coke++ | 3 files
Migrate to Pod::Utils

Hand-applied most of github.com/Raku/rakudoc/pull/23 by pheix		 16:15
rakudoc/main: d492f403c7 | mujo-hash++ (committed using GitHub Web editor) | t/04-compunit.t
Remove failing test (#15)

To replicate failure, install zef, then run `zef install rakudoc` If rakudoc is the first module installed with zef, then it will fail. See issue #13 for details.
Fixes #13 Closes #14 Closes #12		 16:20
doc/main: f6a037fed0 | cfa++ | doc/Type/List.rakudoc
use v6.e.PREVIEW for rotor examples
 17:22
17:23 cfa joined
cfa 👋 17:24
lizmat: i think this signature needs to be updated (source after variadic parameters) 17:25
(in 2023.02, i see two rotor signatures: `(Int:D $batch, \thing, *%_)` and `(**@cycle-and-thing, *%_)`) 17:26
oh, whoops, forgot the link: github.com/Raku/doc/blob/main/doc/...udoc#L1211 17:27
18:12 rf_ joined 18:13 rf left
cfa this is odd: 18:32
docs-dev.raku.org/language/subscri...Zen_slices
"Zen slicing does not reification or cache..."
but the underlying pod is:
"Zen slicing does not L<reify|/language/glossary#index-entry-Reify> or L<cache|/routine/cache>"
the generated link text is incorrect 18:33
(the target needs updating but that can wait)
okay, it looks like links to the same target on the same page re-use the first link's link text 18:36
github.com/Raku/doc/blob/main/doc/...kudoc#L114
github.com/Raku/doc/blob/main/doc/...kudoc#L393
note "$*TZ variable" in docs.raku.org/type/DateTime#method_local 18:37
[Coke] prefixed with "index_entry" else it'd work 18:43
cfa that's not the issue
i'm creating one now, will share in a sec
[Coke] thanks 18:44
cfa github.com/finanalyst/raku-pod-render/issues/16 18:46
btw [Coke], sent you a pr yesterday
and re: the index entry prefix, i was about to amend when i spotted this (more serious) issue 18:47
not sure how pervasive this is 18:53
[Coke] what's V<> ? 18:57
cfa verbatim i think 19:05
Geth doc/main: 23dca2842e | cfa++ (committed using GitHub Web editor) | 11 files
Remove formatting codes from various examples (#4262)

These don't currently render correctly on the doc website and in some cases make example source more difficult to read and maintain. Output presentation has also been tidied.
  (If these codes are permitted in future, consider reverting this commit.)		 19:06
19:13 rf_ left, rf joined 19:27 cfa left
lizmat cfa: (**@cycle-and-thing, *%_) doesn't really tell anything about how the parameters are handled 22:42
23:47 lizmat left 23:48 lizmat joined

Powered by Cro and the Raku® Programming Language.

Please report any issues / comments / feature requests as an issue on App::Raku::Log.

Thank you!