Dear Nixers, dear fellow documentarians,
as part of the effort to reduce the load on the public binary cache, I intend to use the Open Collective funds for documentation work to create official tutorials on nix.dev for people to self-host their own cache.
- Setting up a binary cache · Issue #1012 · NixOS/nix.dev · GitHub
- Setting up distributed builds · Issue #1013 · NixOS/nix.dev · GitHub
- Provisioning remote machines · Issue #1014 · NixOS/nix.dev · GitHub
- List all "common eval args" in classic CLI documentation · Issue #11070 · NixOS/nix · GitHub
- There may be more detail work required on reference documentation to complete the tutorials
Budget: 5000 EUR (plus VAT in the Eurozone)
Timeline: finish by 2024-09-18, 10 weeks from now
Quality requirements:
- Text should be accessible to a non-expert technical audience
- All steps should be fully reproducible from what’s present in the text
- Follow the respective style guides
Your profile:
- proficient in Markdown, Git, GitHub (required)
- demonstrable experience with technical writing (required)
- fluent with Nix and NixOS (strong bonus)
- experience working with Sphinx/Myst (bonus)
- available 8:00-13:00 UTC for at least weekly video calls to do collaborative reviews and editing sessions
Depending on your level of experience, the timeline allows you to trade the resulting hourly rate against an opportunity to learn on the job and build up some Nix expertise. But finishing quickly is of course desirable. I will guide you through the process and can provide sample code.
Please contact me until Wednesday 2024-07-23 here on Discourse or on Matrix with relevant (ideally open source) work samples and a sketch of how you would approach the task. I will prefer Nix ecosystem contributors in the selection process, but all applicants are welcome.