Community
The Documentation Team can be found in a number of places. Check the Documentation Team page and drop in if you’d like to contribute!
The Learning Journey Working Group won’t have meetings in the month of September (or at least I/@zmitchell won’t be leading them). Next week is NixCon, and several members of the Documentation Team will be there either attending and/or speaking (including me/@zmitchell, @fricklerhandwerk, and @infinisil)!
Projects
nix.dev
After what seems like a long time, nix.dev is now official! The tracking issue for this process is here: nix.dev#481. You can read more about the history behind this site in the official nix.dev announcement post.
New official tutorials
The Learning Journey Working Group was started in order to create a tutorial series that will take people from “never seen Nix” to competent Nix users.
We’ve spent a few months figuring out which tutorials to write, developing processes, etc, and we finally have some tutorials to show for it. All of the tutorials are hosted on nix.dev:
- Creating shell environments
- Sharing dependencies between
default.nixandshell.nix - Packaging existing software with Nix
The new tutorial series is intended to start from a blank slate, so at the moment there is some overlap with tutorials under the “First Steps” section of nix.dev. The intention is to quickly merge the two, removing redundancies so that there’s no competing instructions on the site.
Python section of the Nixpkgs manual
@alejandrosame has been hard at work taking stock of the Python section of the Nixpkgs manual, categorizing the various materials it contains, and deciding what a better organizational structure would look like.
The tracking issue for this effort is in nixpkgs#246234.
Nixpkgs contribution manual
One of the main draws of the Nix ecosystem is the huge collection of packages in the Nixpkgs repository. Contributing to any open source project can be intimidating, much less the largest single package repository on the planet. In an effort to make contribution easier and keep the instructions all in one place, @infinisil moved and cleaned up parts of the manual.
Documentation PRs Merged
NixOS/nix
- #8788 Port the flags of nix-daemon to nix daemon (@bryanhonof)
- #8774 Add infra for experimental store implementations (@Ericson2314)
- #8723 revert anchor prefix for builtin constants (@fricklerhandwerk)
- #8682 Fix some grammar in installables doc (@balattar)
- #8640 Document the path flakeref format (@thufschmitt)
- #8631 Profile list improvements (@iFreilicht)
- #8596 clarify wording on args@ default handling (@fricklerhandwerk)
- #7973 remove the Channels section (@fricklerhandwerk)
NixOS/nixpkgs
- #250548 nixpkgs manual: doc python: render manual notes as admonitions (@alejandrosame)
- #247424 CONTRIBUTING: remove suggestion about the order of arguments (@AndersonTorres)
- #245358 doc/contributing: update build instructions after nrd (@asymmetric)
- #240136 doc/reviewing-contributions: Add points about patches (@roberth)
-
#252225 fetchers: Add
fetchDebianPatch(@nbraud) - #252041 prometheus-unbound-exporter: replace at 0.4.4 (@mweinelt)
- #251412 odoo: 15.20230317 → 16.20230722 (@karolinschlegel)
- #251293 pass: stop installing password-store.el (@jian-lin)
- #251284 emacs: improve doc (@jian-lin)
- #251264 [staging-next] wafHook: fix missing header id (@marsam)
- #250778 staging-next 2023-08-22 (@vcunat)
- #250316 nixos/switch-to-configuration: Improve mount unit handling (@dasJ)
- #249982 chickenPackages: turn into scope, update (@nagy)
- #249765 nixos/honk: init (@drupol)
- #249712 nixos/cinnamon: Override Qt apps style again (@bobby285271)
- #249502 nixos/influxdb2: add provisioning and nixos tests (@oddlama)
- #249251 Waf: refactor (@AndersonTorres)
- #249175 nixos/nncp: add caller and daemon services (@ehmry)
- #249105 doc/stdenv/stdenv.chapter.md: add information about nix-update-script and nixpkgs-update (@NickHu)
-
#248988 lib.customisation.makeScope: Make
overrideScopeconsistent withmakeScopeWithSplicing(@Artturin) - #248984 html-proofer: 3.18.8 → 5.0.8 (@alejandro-angulo)
- #248701 nixos/install-tools: Add manpages to packages instead of seperating them (@doronbehar)
- #248544 nixos/pantheon, nixos/cinnamon: Drop qgnomeplatform (@bobby285271)
- #248496 staging-next 2023-08-11 (@vcunat)
- #248243 zig.hook: rename from zigHook (@figsoda)
- #247920 testers.hasPkgConfigModules: allow checking multiple pkg-config mods (@sternenseemann)
- #247357 emacs: update to 29.1 (@AndersonTorres)
- #247314 nixos/nextcloud: make php settings additive (@Ma27)
- #247130 treewide: update mainProgram docs (@Artturin)
- #247117 Documentation: nixpkgs manual: move Python reference to the top of Python chapter (@alejandrosame)
- #246956 nixpkgs manual, doc Python: render interpreters in a table (@alejandrosame)
- #246867 add mpiCheckPhaseHook (@markuskowa)
- #246842 nixos/mautrix-whatsapp: init (@frederictobiasc)
- #246186 woodpecker-*: 0.15.11 → 1.0.0 (@ambroisie)
NixOS/nix-pills
- #218 Grammatical adjustments to Nix Pill 19 (@camelpunch)
- #216 Pill10 (@henrik-ch)
- #214 Pill 8 update (@henrik-ch)
NixOS/nix.dev
- #703 highlight call for donations (@fricklerhandwerk)
- #699 Update sharing deps tutorial (@zmitchell)
- #694 Add the Magic Nix Cache as an option to the GitHub Actions page (@grahamc)
- #693 Remove gitpod (@proofconstruction)
- #690 remove regex that breaks copy button (@proofconstruction)
- #689 Fixed a typo (@frencojobs)
- #687 Update documentation-survey.md (@JillThornhill)
- #686 Update documentation-survey.md (@JillThornhill)
- #685 this-month-in-nix-docs: Get both documentation labels for Nixpkgs (@infinisil)
- #682 Update documentation-survey.md (@JillThornhill)
-
#680
CODEOWNERS: remove domenkozar, add docs team (@asymmetric) - #679 Add line numbers to Nix, Python code blocks (@asymmetric)
- #677 https://edolstra.github.io/pubs/phd-thesis.pdf Chapter 2 (@JillThornhill)
- #676 Update documentation-survey.md (@JillThornhill)
- #675 Add sharing deps tutorial (@zmitchell)
- #674 Tweak shell.nix tutorial (@zmitchell)
- #671 Add shell.nix tutorial (@zmitchell)
- #669 Update diataxis links (@yukiisbored)
- #668 Add styles for diffs (@yukiisbored)
- #667 Clarify and fix grammar/spelling mistakes in the installation guide for the Raspberry Pi (@jtbx)
- #666 Fix typo in faq.md (@michaelshmitty)
- #664 Fix broken Diataxis links (@zmitchell)
- #663 Explain chained script interpreter (@zmitchell)
- #661 Update ad-hoc-shell-environments.md (@twiclo)
- #659 small touch-up - removing non-NixOS referral (@henrik-ch)
- #658 Fix small typo (@Confidenceman02)
- #656 adding note about using etcher when on non-nixos system. (@henrik-ch)
- #655 Update nix-language.md (@Carlos-Marques)
- #653 expand contribution guidelines (@fricklerhandwerk)