Age | Commit message (Collapse) | Author | |
---|---|---|---|
2022-12-20 | add more explanation to diagrams | Valentin Gagarin | |
this is to help reading the diagrams, otherwise arrows and labels were reported as being ambiguous. | |||
2022-12-12 | suggestions from review | Valentin Gagarin | |
2022-11-09 | remove external link | Valentin Gagarin | |
the language has its own overview page where its properties are described in sufficient detail. | |||
2022-11-09 | make diagrams compatible with svgbob | Valentin Gagarin | |
this will at some point enable rendering them nicely for the web | |||
2022-11-09 | clarify subject of sentence | Valentin Gagarin | |
Co-authored-by: Bryan Honof <bryan.honof@tweag.io> | |||
2022-11-09 | add articles | Valentin Gagarin | |
2022-11-09 | manual: architecture overview | Valentin Gagarin | |
these changes were not merged properly and had to be reverted. see merge commit d8e54d19f71f78540dd967b2e42be6a5d8a0b1bb for full history leading up to here. | |||
2022-08-22 | Revert "Merge pull request #6420 from nix-community/doc-what-is-nix" | Valentin Gagarin | |
This reverts commit 81e101345fda2a8651c470f08b364a1ca6fa37cf, reversing changes made to 7d1280bbaf7f4cd142c2259dec620c42bf6f96fd. | |||
2022-08-04 | Add disclaimer that arch section is WIP and links may rot | John Ericson | |
So we can iterate without worrying so much. | |||
2022-08-04 | Remove header fragments which is not needd | John Ericson | |
2022-08-04 | Fix rosetta stone file name | John Ericson | |
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 | 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 |