Meeting: 2022 07 09

Date: 2022-07-09, 1600 UTC (noon Eastern), 30min

Jit.si call

Attendees: Coke, Richard, Alexander, Coleman, Luis

Objective

Coordinate work on docs site migration?

Questions

• Is there any work that absolutely must be done on the current site, or can we live with it being out of date until the migration? (Coleman)
  • Coke: No;
• What's the solution to implement for https://gist.github.com/Altai-man/c15e580480d44616eace320ccda95ed3 ?
• Do we need /syntax pages? /routine pages are alright (objections?)

Agenda

1. Welcome intros (Coke)
2. Review blockers to site migration (Coke)

• Do we need /syntax pages? /routine pages are alright (objections?)

Action Items

• Digest Cro issues and tell Jonathan they are showstoppers for us (Coke)
• Start an issue on Richard's site re: to point Richard where Documentable is used (Richard)
  • https://github.com/Altai-man/docs.raku.org/issues/67
• Read Alexander's gist and comment on problems on search (Coke - or delegate)
• Talk to the Devops team (Roman and ???) about packaging requirements for new site (Coke)

General Goal 🦋

• Need to make it easier to contribute to docs; Make it easy and folks will do it!

---

Notes

Blockers in Cro project;

• Showstoppers - unknown timeline.
  • two tickets: find them
• Search is bad -
• https://github.com/Altai-man/docs.raku.org/issues/65

https://github.com/Altai-man/docs.raku.org/issues/65 https://github.com/Altai-man/docs.raku.org/issues/65 http://raku.finanalyst.org/ https://gist.github.com/Altai-man/c15e580480d44616eace320ccda95ed3 https://raku.finanalyst.org/error-report.html

Richard's objections to Documentable:

• Do we need /syntax pages? /routine pages are alright (objections?) proposal: remove them; documentable artifacts two aspects: pod structure is what you write; how does it look?
• Proposal: Wherever there's a link to a secondary/generated file - link is changed to text part.

Alexander:

• we should generate less
• but we should keep /routines -