| Age | Commit message (Collapse) | Author | |
|---|---|---|---|
| 2022-08-04 | fix page rendering | Valentin Gagarin | |
| apparently it is not possible to link to page anchors with `mdBook`[1] [1]: https://github.com/rust-lang/mdBook/issues/167 | |||
| 2022-08-04 | use correct mdBook syntax for callouts | Valentin Gagarin | |
| 2022-08-04 | fix directory tree renderings | Valentin Gagarin | |
| 2022-08-04 | clarify what explicitly declaring certain dependencies means | Valentin Gagarin | |
| 2022-08-04 | move architecture to the end | Valentin Gagarin | |
| 2022-08-04 | add file system object to table of contents | Valentin Gagarin | |
| 2022-08-04 | clarify what store objects can be | Valentin Gagarin | |
| the store of course makes a distinction, but that is not relevant here | |||
| 2022-08-04 | add Java example on manual dependency declaration | Valentin Gagarin | |
| 2022-08-04 | hashes: truncate -> reduce, mention SHA-256 | Valentin Gagarin | |
| the longer SHA-256 hashes are not truncated, but in fact processed. Co-authored-by: Thomas <twatson52@mac.com> | |||
| 2022-08-04 | mention hard links | Valentin Gagarin | |
| Co-authored-by: Thomas <twatson52@mac.com> | |||
| 2022-08-04 | use "build plan" consistently | Valentin Gagarin | |
| 2022-08-04 | note customized base32 | Valentin Gagarin | |
| Nix omits E O U T characters for some reason. | |||
| 2022-08-04 | use correct Nix entity | Valentin Gagarin | |
| Nix itself does care a lot about what type of store object you have. | |||
| 2022-08-04 | fix typo | Valentin Gagarin | |
| Co-authored-by: Thomas <twatson52@mac.com> | |||
| 2022-08-04 | add subsections to table of contents | Valentin Gagarin | |
| 2022-08-04 | concept map: align hights | Valentin Gagarin | |
| this has the weird but nice emergent property that terms at the same height are roughly at the same level of abstraction. | |||
| 2022-08-04 | concept map: put closure as it is in the chapter | Valentin Gagarin | |
| this is not as compact any more, but it more closely resembles the chapter structure, and clearly shows that the closure property is the key idea on which most of Nix operates. | |||
| 2022-08-04 | make concept map even more compact | Valentin Gagarin | |
| 2022-08-04 | make concept map more compact | Valentin Gagarin | |
| invert arrows to/from derivation: - we need closures to form derivations - we need derivations to perform builds | |||
| 2022-08-04 | store: add concept map | Valentin Gagarin | |
| this should help nativate the chapter by indicating which terms should be known to understand a given concept. | |||
| 2022-08-04 | store: match chapter introduction to outline | Valentin Gagarin | |
| the various levels of detail should describe the same things. | |||
| 2022-08-04 | simplify description of diagram | Valentin Gagarin | |
| try not to be too fancy, it's just for reading the diagram out loud. | |||
| 2022-08-04 | reword notes on copying | Valentin Gagarin | |
| clarify that we are copying between different stores. we have not introduced that notion or why it would be interesting, but for now it should be fine to keep it in context of the store directory. we could move that later to a more detailed explanation of different store types. | |||
| 2022-08-04 | make example a simple list | Valentin Gagarin | |
| using JSON notation is unwarranted and not explained. | |||
| 2022-08-04 | paths -> path | Valentin Gagarin | |
| use singular for terminology uniformly | |||
| 2022-08-04 | better explain reference scanning | Valentin Gagarin | |
| 2022-08-04 | explain store directory | Valentin Gagarin | |
| 2022-08-04 | add explanation and examples of file system objects | Valentin Gagarin | |
| 2022-08-04 | remove diagonal from operations diagram | Valentin Gagarin | |
| 2022-08-04 | remove draft on derivations | Valentin Gagarin | |
| 2022-08-04 | move first mention of file system object before diagram | Valentin Gagarin | |
| 2022-08-04 | make clear that file system is for processes | Valentin Gagarin | |
| Co-authored-by: John Ericson <John.Ericson@Obsidian.Systems> | |||
| 2022-08-04 | constrain garbage collection scope | Valentin Gagarin | |
| garbage collection is now incremental, and may (in theory) never delete all unreferenced objects if it is slow enough. | |||
| 2022-08-04 | references are added according to build task | Valentin Gagarin | |
| at this level of abstraction we do not really care about build instructions or what they are, and also build instructions including their arguments really amount to the build task. | |||
| 2022-08-04 | operations diagram: store' to the right | Valentin Gagarin | |
| this also looks more diverse, hopefully easier to distinguish Co-authored-by: John Ericson <John.Ericson@Obsidian.Systems> | |||
| 2022-08-04 | add commas between output values | Valentin Gagarin | |
| 2022-08-04 | use singular to match section heading | Valentin Gagarin | |
| 2022-08-04 | use reference links for URLs | Valentin Gagarin | |
| 2022-08-04 | add subsections for objects and references | Valentin Gagarin | |
| group description of data instead of spreading it across the section. that should help direct skimming. as it turns out, people do not actually read any of that. | |||
| 2022-08-04 | move closure property to discussion references | Valentin Gagarin | |
| 2022-08-04 | replace pseudo code by diagrams | Valentin Gagarin | |
| change prose description to visually resemble the data structure | |||
| 2022-08-04 | use reference links for URLs | Valentin Gagarin | |
| 2022-08-04 | clarify first sentence on store objects | Valentin Gagarin | |
| 2022-08-04 | fix grammar for clarity | Valentin Gagarin | |
| 2022-08-04 | introduce mapping to Unix files and processes | Valentin Gagarin | |
| 2022-08-04 | introduce store and store objects without file system details | Valentin Gagarin | |
| this leaves open implementation details, especially about store paths and file system objects, and allows explaining them together were it is more appropriate. also leaves room to carefully introduce the key insight behind Nix: applying results from programming language theory to the operating system paradigm of files and processes. | |||
| 2022-08-04 | beautify rosetta table | Valentin Gagarin | |
| while this may eventually introduce ugly diffs, the table will now render readably on the terminal (e.g. for `man nix` or `nix --help`) without further intervention. | |||
| 2022-08-04 | use reference links for URLs | Valentin Gagarin | |
| 2022-08-04 | introduce build tasks | Valentin Gagarin | |
| while it appears a bit much for the overview, this way we set the stage for going directly into data types when describing the store, instead of first having to say what build tasks are and how they relate to build plans. | |||
| 2022-08-04 | revert to build plans in top-level overview | Valentin Gagarin | |
| do not introduce build tasks yet, that is the next level of detail. | |||
 |
index : lix | |
| User & |
| aboutsummaryrefslogtreecommitdiff |