2023-06-29 - Learning Journey Working Group - Meeting Notes #15

[zmitchell]

• Previous meeting notes
• Attendees: @henrik-ch @zmitchell @proofconstruction @fricklerhandwerk @brianmcgee
• Notes taken by: @fricklerhandwerk

Agenda

• group-review of tutorial outlines

Notes

• general discussion on tutorial design
• considerations on ease of contributing
  • Diataxis makes it hard to categorise materials and the pace is frustrating
• discussed balancing community effort with coordinated maintenance

Group reviews

• Add outline for "sharing deps" tutorial by zmitchell · Pull Request #622 · NixOS/nix.dev · GitHub
  • general agrement, needs slight updates
• Learning Journey tutorial - making a derivation · Issue #599 · NixOS/nix.dev · GitHub
  • should focus more on instructions to get to the result

Action items

• @zmitchell: write up my condensed description of Diataxis categorization
  • Include a section connecting what you want to write to what category it is
    • “I want to dig in to the details” → explanation
    • etc