[11:02] <lizmat> starting with RakuAST class documentation

[11:07] <lizmat> feels like the Type/RakuAST.rakudoc should be moved to a more Intro-like page, and then be updated.

[11:08] <lizmat> [Coke]: would it be ok to remove the ":preamble<use experimental :rakuast>" from the code examples?

[11:10] <Geth> ¦ doc/main: e92d0dc85e | (Elizabeth Mattijsen)++ | 5 files

[11:10] <Geth> ¦ doc/main: Remove mention of experimental :rakuast

[11:10] <Geth> ¦ doc/main: 

[11:10] <Geth> ¦ doc/main: Looking forward, I think "experimental :rakuast" should only be

[11:10] <Geth> ¦ doc/main: mentioned once, at the top level and some introduction.

[11:10] <Geth> ¦ doc/main: review: https://github.com/Raku/doc/commit/e92d0dc85e

[11:24] <lizmat> yeah, I think it's ok, as we run all the test on the latest Rakudo release

[11:25] <Geth> ¦ doc/main: 8aa79a7a4a | (Elizabeth Mattijsen)++ | 5 files

[11:25] <Geth> ¦ doc/main: Be consistent in markup

[11:25] <Geth> ¦ doc/main: 

[11:25] <Geth> ¦ doc/main: 1. Be explicit about what code is, so don't assume that indented

[11:25] <Geth> ¦ doc/main:    text will be code

[11:25] <Geth> ¦ doc/main: 2. Remove mention of "use experimental :rakuast" from preambles

[11:25] <Geth> ¦ doc/main: 3. Remove mention of ":lang<raku>" from code blocks, that *is* implicit

[11:25] <Geth> ¦ doc/main: review: https://github.com/Raku/doc/commit/8aa79a7a4a

[11:37] <lizmat> meh... looks like the CI runner for doc isn't updated yet?

[12:01] <Geth> ¦ doc/main: 70eadad54e | (Elizabeth Mattijsen)++ | doc/Type/RakuAST/Doc/Block.rakudoc

[12:01] <Geth> ¦ doc/main: Some clarifications

[12:01] <Geth> ¦ doc/main: 

[12:01] <Geth> ¦ doc/main: - don't use =foo as example, when the previous was =for, to avoid

[12:01] <Geth> ¦ doc/main:   confusion

[12:01] <Geth> ¦ doc/main: - separate the rakudoc from the raku parts in examples

[12:01] <Geth> ¦ doc/main: review: https://github.com/Raku/doc/commit/70eadad54e

[12:02] <Geth> ¦ doc/main: bf1c68b25d | (Elizabeth Mattijsen)++ | doc/Type/RakuAST/Doc.rakudoc

[12:02] <Geth> ¦ doc/main: Cleanup of RakuAST:Doc overview document

[12:02] <Geth> ¦ doc/main: review: https://github.com/Raku/doc/commit/bf1c68b25d

[13:02] <[Coke]> I am using a home grown docker image for docs, I'll update it.

[13:04] <Geth> ¦ doc: coke self-assigned Test runner pinned on old version https://github.com/Raku/doc/issues/4824

[13:10] <[Coke]> Based on: FROM rakudo-star:latest

[13:13] <[Coke]> Looks like that hasn't been pushed yet.

[14:38] *** camelia left
[14:39] *** camelia joined
[14:49] <[Coke]> the example here: https://docs.raku.org/type/RakuAST.html says that "say" is in the output of hello world, but it would just be the string

[14:50] <[Coke]> same issue with the example before it - the say is saying the output, it's not part of the AST getting parsed.

[16:26] <Geth> ¦ doc/main: 8a22fe8ce5 | (Elizabeth Mattijsen)++ | doc/Type/RakuAST.rakudoc

[16:26] <Geth> ¦ doc/main: Several tweaks and fixes

[16:26] <Geth> ¦ doc/main: 

[16:26] <Geth> ¦ doc/main: Fixes #4825

[16:26] <Geth> ¦ doc/main: review: https://github.com/Raku/doc/commit/8a22fe8ce5

[16:29] <[Coke]> lizmat: why are you reformatting the rakudoc as you go?

[16:29] <lizmat> you mean adding =begin code blocks ?

[16:29] <[Coke]> I do not like the verbose version of "begin code" for a single line item.

[16:29] <lizmat> ah

[16:29] <[Coke]> yup. Just curious why you're doing it, is it a rakudoc v2 prep?

[16:30] <lizmat> no, it isn't, it's just trying to be consistent

[16:30] <lizmat> for the not so experienced rakudoc readers

[16:30] <[Coke]> ... with what?

[16:30] <[Coke]> the audience of people reading the rakudoc vs. the rendered HTML is probably very low.

[16:30] <lizmat> well, have some indented blocks in one place in a file, and in another we have =begin/end code blocks

[16:31] <[Coke]> That sort of style issue - let's agree on that first before making changes across the board.

[16:31] <lizmat> ok, understood..   will change those back  no worries

[16:31] <[Coke]> (no need to rewind those changes)

[16:32] <lizmat> no, let's at least be consistent about that inconsistency  :-)

[16:34] <[Coke]> (I also would prefer we write a test to enforce the style and then pass the test)

[16:35] <[Coke]> we've done that with other style related items in the past

[16:35] <[Coke]> ... I should also relook at some of the doc tests now that we are guaranteed to have ast.

[16:35] <[Coke]> ... once we get the tests running with 2026.09

[16:36] <Geth> ¦ doc/main: 089477701d | (Elizabeth Mattijsen)++ | 7 files

[16:36] <Geth> ¦ doc/main: Change description of a single line of code without preamble

[16:36] <Geth> ¦ doc/main: 

[16:36] <Geth> ¦ doc/main: It should be indented with 4 spaces without =begin/end code

[16:36] <Geth> ¦ doc/main: review: https://github.com/Raku/doc/commit/089477701d