diff --git a/maintainers/working_groups/learning_journey/documentation-survey.md b/maintainers/working_groups/learning_journey/documentation-survey.md index 929d69e21..843816df5 100644 --- a/maintainers/working_groups/learning_journey/documentation-survey.md +++ b/maintainers/working_groups/learning_journey/documentation-survey.md @@ -145,12 +145,29 @@ To better navigate the material and judge its relevance, every entry should prov - https://edolstra.github.io/pubs/phd-thesis.pdf - Chapter 1: + Chapter 1: Existing software deployment models and issues faced with them; motivation for developing Nix, features of the Nix deployment system - Reading time: 15 min - Author: Eelco Dolstra - Created: 2006 + + Chapter 2: + + 2.1: The Nix Store, isolation of components, cryptographic hashes, non-destructive upgrades, prevention of undeclared dependencies, closures + + 2.2: Use of Nix expressions to build software, structure of Nixpkgs collection, Hello and SUbversion as examples of derivations. + + 2.3: Package Management: Installations, updates and rollbacks, user environments, uninstalling, garbage collection + + 2.4: Store derivations: Definition, `.drv` files in Nix store. `nix-instantiate`, `nix-store --realise`. Allows various deployment policies, including source and binary. + + 2.5. Deployment models. Mechanisms `nix-instantiate` and `nix-store`. Models: Manual download; vesion management system; channels; one-click installation + + 2.6: Transparent source/binary deployment: `nix-push` and `nix-pull`. Pre-built substitutes. + + - Reading time: 30 min + ### Nixpkgs