Documentation Channel for #raku | This channel is logged | Roadmap:
Set by [Coke] on 23 May 2022.
[Coke] Ugh. not being able to build OpenSSL on mac m2 is getting to be a blocker. 00:59
cfa what's the issue? 01:18
[Coke] 01:19
cfa oh, odd 01:20
[Coke] Made some progress on that ticket - at least I think I have compatible versions of the openssl lib and raku 02:12
commented. is 33% done (That's the one I set to be done by end of March). 02:49
several of these are PRs that are done or mostly done, a few are more meta than docs. 02:54
Need to close 1.1 tickets a day to make it. 02:58
03:04 cfa left
coleman I've migrated all CI containers off my personal server into the raku-infra Hetzner 03:06
I need to make the "hourly" build into an "every two hours" build, because we're burning too many build minutes right now 03:31
The build is too slow, so if we can speed it up we can bring back that higher frequency
every PR will still be built, though 03:32
deployed prod so we can start collecting logs 04:41
i checked the dev server and the new logging config indeed adds more access logging 04:42
so that's why i pushed to prod 04:43
oh i'm a dummy i forgot to update the highlighters on my new server 04:45
rebuilding on the old agents... 04:48
fixed 05:11
06:55 rf left, sjn left 06:56 rf joined, sjn joined 08:45 sena_kun joined 09:25 rf left 09:26 rf joined
lizmat I wonder whether there should be a distinct way to link to a module in the ecosystem 10:10
referring with an absolute URL as feels fragile
10:58 Geth joined
Geth doc/main: bd6c4c8538 | (Tom Browder)++ (committed by Will Coleda) | util/create-brackets-table.raku
Modify the 'Brackets' table generator to always read the data source file

The following changes have been made:
  + removed hard-wired file paths
  + ensured the output table has no trailing spaces
  + eliminated the 'Reorder' and 'original' options
... (9 more lines)
doc/main: cf466799ec | (Tom Browder)++ (committed by Will Coleda) | 2 files
ensure module is available, use local NQP source if available
doc/main: cd8914361a | (Tom Browder)++ (committed by Will Coleda) | util/create-brackets-table.raku
add another possibility for location of NQP
doc/main: e099f8252f | (Will Coleda)++ | doc/Type/Complex.pod6
Add Complex.sign for v6.e

Closes #4199
doc/main: e099f8252f | (Will Coleda)++ | doc/Type/Complex.pod6
Add Complex.sign for v6.e

Closes #4199
doc/main: 58d64f0d6d | (Elizabeth Mattijsen)++ | doc/Type/Complex.pod6
Add documentation for Complex.sign
doc-website/main: f80c1cf450 | (Coleman McFarland)++ (committed using GitHub Web editor) | .buildkite/pipeline.yaml
Omit progress bars on CI (#191)

In non-interactive scenarios progress bars take up too much log space.
doc/main: 90025302b1 | (Elizabeth Mattijsen)++ | doc/Type/Unicode.pod6
Document new Unicode class
doc/main: 966a99d473 | (Elizabeth Mattijsen)++ | doc/Language/variables.pod6
Document $*EXIT and $*EXCEPTION
lizmat ok, that's the missing pushes re-delivered
[Coke] looks like we had a bit of a class re Complex.sign... could you reconcile ? 11:05
Geth doc/finanalyst-patch-1: 89e8bc4be8 | (Richard Hainsworth)++ (committed using GitHub Web editor) | doc/Type/DateTime.pod6
Update DateTime.pod6

typo in href
doc: finanalyst++ created pull request #4237:
Update DateTime.pod6
doc/finanalyst-patch-5: 6a2d8091e6 | (Richard Hainsworth)++ (committed using GitHub Web editor) | doc/Language/modules-extra.pod6
Update modules-extra.pod6

Rename p6doc to rakudoc
doc: finanalyst++ created pull request #4238:
Update modules-extra.pod6
doc/main: 50c7b8a533 | (Elizabeth Mattijsen)++ | doc/Type/RakuAST.pod6
Add RakuAST package stub
doc/finanalyst-patch-3: 7af34eea6d | (Richard Hainsworth)++ (committed using GitHub Web editor) | doc/Language/faq.pod6
Update faq.pod6

change malformed links and change to rakudoc
doc: finanalyst++ created pull request #4239:
Update faq.pod6
¦ doc-website: finanalyst self-assigned use of nested in POD 11:34
doc/main: e41bf648fb | (Elizabeth Mattijsen)++ | doc/Language/experimental.pod6
Document "use experimental :rakuast"
11:58 rf left, rf joined 12:06 rf left, rf joined
Geth doc/main: 952c044cca | (Elizabeth Mattijsen)++ | doc/Language/create-cli.pod6
Document %SUB-MAIN-OPTS<allow-no|numeric-suffix-as-value>
doc/main: fbb97b6ffb | (Elizabeth Mattijsen)++ | doc/Language/terms.pod6
Document nano term
doc/main: c1871a78a6 | (Elizabeth Mattijsen)++ | doc/Type/IO/Path.pod6
Document IO::Path.created
doc/main: bc3d233986 | (Elizabeth Mattijsen)++ | doc/Type/Dateish.pod6
Document Dateish.days-in-year
doc/main: 93fd8d182d | (Elizabeth Mattijsen)++ | doc/Type/Any.pod6
Elaborate on Any.are
14:59 cfa joined
Geth doc/main: e6fcf63e92 | cfa++ | doc/Language/variables.pod6
Fix typo
doc/main: e670a5bc84 | cfa++ | xt/pws/words.pws
Add 'nano' and 'rakuast' to the dictionary.
lizmat cfa++ 15:33
quality control 15:34
cfa :P 15:35
[Coke]: some of these checklist entries just copy over rakudo additions and removals that aren't relevant to public facing documentation, correct? 15:44
Geth doc/main: 442a6cb764 | cfa++ | xt/headings.rakutest
Add RakuAST and package checks to xt/headings.rakutest
doc/main: 43dbbbcd25 | cfa++ | doc/Type/Unicode.pod6
Fix link typo
doc/main: 874de5de52 | cfa++ | xt/link-checker.rakutest
Remove trailing whitespace from xt/link-checker.rakutest
lizmat cfa++ again 16:34
Geth doc/main: ce3d70d95d | (Elizabeth Mattijsen)++ | 2 files
Document the 6.e features of Seq.skip

  - move some of the Any.skip doc to Seq.skip
  - correct output of existing examples (spaces instead of commas)
doc/main: 185749469f | cfa++ | xt/link-checker.rakutest
Fix xt/link-checker.rakutest: s/fail/flunk/
doc: cfa++ created pull request #4240:
link-checker: Check for the existence of directories as well as pod6 files
doc/main: 0b21b1dbe2 | cfa++ | 3 files
Remove .html from links failing xt/link-checker.rakutest
[Coke] cfa: yes, the checklists are just raw copies of hte changelog, some of these items aren't user facing. just check those. 17:25
cfa nods
[Coke] ponders making HTTP::UserAgent entirely optional so we can remove it from the META6.json so my automatic stuff doesn't die every time I try to install it 17:26
lizmat: saw your note about Complex.sign, investigating after this test run 17:27
lizmat oki
cfa [Coke]: sent a pr your way; all tests should pass if that's merged
[Coke] ... so I shouldn't be investigating test failures atm? 17:28
ok. will merge first
Sorry, this is a welcome but unusual chagne. :)
Geth doc/main: d0492c509e | cfa++ (committed by Will Coleda) | xt/link-checker.rakutest
xt/link-checker.rakutest: check for the existence of a dir as well as .pod6 file
lizmat got one test fail now: Failed test 'xt/type-graph.rakutest Pod6 and syntax check out' 17:31
Geth doc/main: 409389831b | (Will Coleda)++ | doc/Language/faq.pod6
Update rakudoc link

Courtesy finanalyst++
Update zef link to direct link
doc/main: 362b54e69d | (Richard Hainsworth)++ (committed by Will Coleda) | doc/Language/modules-extra.pod6
Update modules-extra.pod6

Rename p6doc to rakudoc
doc/main: 00526c6bca | (Richard Hainsworth)++ (committed by Will Coleda) | doc/Type/DateTime.pod6
Update DateTime.pod6

typo in href
doc/main: 257d4d343d | (Tom Browder)++ (committed by Will Coleda) | doc/Language/objects.pod6
Correct the intended zero-width index entries
doc/main: 3c8cca2ffb | (Tom Browder)++ (committed by Will Coleda) | doc/Language/objects.pod6
remove TODO which is no longer needed
[Coke] merged all PRs except Kaiepi's.
cfa: good fix on the link test. 17:36
lizmat [Coke] OOC, why not Kaiepi's? 17:37
[Coke] ... Haven't gotten that far. 17:40
Geth doc/main: 0841a64070 | (Will Coleda)++ | 2 files
word used outside of code
doc/main: 9f3014c5f6 | (Will Coleda)++ | doc/Type/Seq.pod6
fix typo
doc/main: 6970032b4f | (Will Coleda)++ | doc/Type/Seq.pod6
[Coke] they were all in draft, some were substantial.
[Coke] If someone wants to review his PRs, please feel free to self assign/comment, etc. 17:42
was not expecting this much work done since yesterday, thanks everyone!
cfa lizmat: xt/type-graph.rakutest passes for me 18:00
(after [Coke]'s changes, everything passes in test and xtest here) 18:01
lizmat maybe it's something I need to install ?
[Coke] all deps are listed in the meta 18:02
cfa is graphviz (dot) installed? 18:03
lizmat i guess not
so how do I install that?
coleman This weekend I will work on Raku/doc CI
[Coke] we shouldn't require dot 18:04
coleman And bringing that stuff into public view
[Coke] how is the test failing?
lizmat Could not find Doc::TypeGraph
coleman I needed dot running the build script last night. ^^^
cfa [Coke]: hmm, type-graph.rakutest depends on Doc::TypeGraph which has a dot dep
lizmat and installing that fails because dot:from<bin> failed
coleman Needed graphviz static libs
[Coke] lizmat: 'zef install --deps-only .'
coleman shared libs rather
[Coke] pretty sure brew has graphviz 18:05
but this test may be going away soon, you can ignore it
lizmat ok, installing with --exclude="dot" --/test
and then the test passes 18:06
[Coke] down to 464 open issues in raku/doc 21:26
we were well over 500 before the new site went live.
lizmat, have a local patch for the Complex.sign dupe, re-installing raku, will test, then push 21:29
lizmat++ cfa++
coleman: let me know if you want to chat about the CI work. I've put thoughts down on various tickets your assigned to. I think we were running out of credits at one point, so definitely want to be mindful of that. If we have an agent that keeps a clone, will speed things up, since the tests create cached pod files 21:30
We can also add a "citest" that is bigger than "test" but smaller than "xtest" (or just make "test" whatever we want "citest" to be.) 21:31
you can skip 04-pod.rakutest to start with (that's the one that creates the cached pod, takes a minute) 21:32
Geth doc/main: 5170cac8b0 | (Will Coleda)++ | doc/Type/Complex.pod6
Combine two versions of .sign we had

¦ doc: coke self-assigned is deprecated section missing 22:02
doc/main: 94c345e387 | (Will Coleda)++ | doc/Type/Routine.pod6
Remove copypasta.

Closes #4225
doc/main: 24ca95d449 | (Will Coleda)++ | .gitignore
Ignore temporary file
22:08 sena_kun left
Geth doc/main: 65c42e0f17 | (Will Coleda)++ | util/new-type.raku
no more vim lines, please
doc/main: 4118f0c239 | (Will Coleda)++ | 5 files
Cleanup more perl6 references.

Closes #3105
[Coke] down to 28 in milestone 22:28
cfa [Coke]++ 22:54
i think some of those paths ought to retain 'perl6' though 22:57
e.g. here i have ~/.rakubrew/versions/moar-2023.02/install/share/perl6
not .../raku
it's just these two: 23:00
also, hmm, the search box respresents a a class A::B::C as A/B/C which isn't ideal 23:04 23:09
& 23:10