2023-10-30 Documentation team meeting notes #90

fricklerhandwerk · November 2, 2023, 4:07pm

Agenda/Notes

@henrik-ch:
- Updated the team pages recently, together with @infinisil
- Didn’t have time for much else. But got into NixOS and now dialing in from NixOS!
  - Very much enjoyed:https://nixos-and-flakes.thiscute.world/
  - Will add that to recommended reading on nix.dev - This cute world NixOS and Flakes unofficial book by henrik-ch · Pull Request #781 · NixOS/nix.dev · GitHub
@mightyiam:
- A Mobus Operandi mob is working 4 hours a week on automated testing of Nix language examples in documentation
  - It’s a CLI you pass a list of file paths to markdown files
  - It will read nix fenced codeblocks and evaluate them with Nix
  - Anyone who wants to contribute can join the mob or message @mightyiam
- @fricklerandwerk: When writing documentation I would care about matching code blocks with the expected evaluation result
@wamirez:
- The Recipes category was now moved into a Guides category on nix.dev, will continue restructuring the FAQs accordingly
- Will update the PR on the channels FAQ with the results from the last session
@djacu:
- working with @sarcasticadmin on a reproducible and immutable software track at SCaLE

Should probably add the concrete example after the line likely causing confusion.

Merged