Age | Commit message (Collapse) | Author | |
---|---|---|---|
2022-08-04 | remove separate meta-section, add architecture diagram | Valentin Gagarin | |
the diagram is a first approximation and only covers that same section. of course there is much more going on, and other features should at some point also be illustrated. we also have to think about presentation format and technicalities behind it. the manual has to render to `man`, but we may want something more refined for web view. | |||
2022-08-04 | reword introductory section | Valentin Gagarin | |
there should be a meta section for each chapter to give motivation of the presented structure. the structure itself is visible from the table of contents. | |||
2022-08-04 | remove sentence for chapter transition | Valentin Gagarin | |
idea: sections could be read in different orders by linking them in different ways (e.g. depth-first or breadth-first). adding hard-coded transitions makes that confusing. | |||
2022-08-04 | Apply suggestions from code review | John Ericson | |
Co-authored-by: Valentin Gagarin <valentin@fricklerhandwerk.de> | |||
2022-08-04 | do not mention implementation details | Valentin Gagarin | |
Co-authored-by: John Ericson <git@JohnEricson.me> | |||
2022-08-04 | correctly use comma for nesting | Valentin Gagarin | |
Co-authored-by: John Ericson <git@JohnEricson.me> | |||
2022-08-04 | indicate sequence with "then" | Valentin Gagarin | |
Co-authored-by: John Ericson <git@JohnEricson.me> | |||
2022-08-04 | only use generic build system terminology | Valentin Gagarin | |
we will use a translation table to introduce nix-specific terms | |||
2022-08-04 | reword overview with clear terminology | Valentin Gagarin | |
trying to capture alternative terms in one go here, mirroring everyday use: derivation - build plan realise - execute build there will be more of that sort. | |||
2022-08-04 | Add draft "Rosetta stone" by @fricklerhandwerk and stub commentary | John Ericson | |
The idea and most of the execution are @fricklerhandwerk's. I changed a few things best I could based on @edolstra's corrections, and a Bazel glossary. Valentin Gagarin <valentin@fricklerhandwerk.de> | |||
2022-08-04 | Make refernces sneak preview more concise | John Ericson | |
2022-08-04 | Improve store objects session more | John Ericson | |
2022-08-04 | Include abstract syntax based on the thesis for FSOs | John Ericson | |
See https://edolstra.github.io/pubs/phd-thesis.pdf, page 91. | |||
2022-08-04 | store objects, better opining sentances | John Ericson | |
2022-08-04 | Improve store path section | John Ericson | |
2022-08-04 | Relocability -> relocation in store object title | John Ericson | |
2022-08-04 | Improve store object section | John Ericson | |
In particular, Nix is *not* like Git, so that needs to be fixed. | |||
2022-08-04 | doc: File system data -> file system object, to match Nix | John Ericson | |
2022-08-04 | Rename files after store entry -> store object rename | John Ericson | |
2022-08-04 | doc: Store entry -> store object | John Ericson | |
This matches the terminology in Eelco's thesis. | |||
2022-08-04 | Update doc/manual/src/design/store/drvs/drvs.md | John Ericson | |
Co-authored-by: Matthieu Coudron <teto@users.noreply.github.com> | |||
2022-08-04 | Update doc/manual/src/design/overview.md | John Ericson | |
Co-authored-by: Valentin Gagarin <valentin@fricklerhandwerk.de> | |||
2022-08-04 | Update doc/manual/src/design/overview.md | John Ericson | |
Co-authored-by: Valentin Gagarin <valentin@fricklerhandwerk.de> | |||
2022-08-04 | Update doc/manual/src/design/overview.md | John Ericson | |
Co-authored-by: Valentin Gagarin <valentin@fricklerhandwerk.de> | |||
2022-08-04 | Fix stub file's name | John Ericson | |
2022-08-04 | Start on the derivations section | John Ericson | |
2022-08-04 | Move the bits on relocating store entires to the end | John Ericson | |
They are too advanced for up front. | |||
2022-08-04 | Apply suggestions from code review | John Ericson | |
2022-08-04 | Flesh out TOC | John Ericson | |
2022-08-04 | Briefly describe the digest of a store path | John Ericson | |
2022-08-04 | WIP: Document the design of Nix | John Ericson | |
The current docs are all "how to do things" and no "what is Nix" or "why are things the way they are". I see lots of misconception on the wider internet, and I also think we would benefit from a "living document" to answer some questions people currently turn to the thesis for. I think a new section of the manual can address all these issues. | |||
2022-08-04 | manual: remove "Writing Nix Expressions" chapter | Valentin Gagarin | |
it is out of date, all over the place in level of detail, is really about `nixpkgs`, and in general instructions should not be part of a reference manual. also: - update redirects and internal links - use "Nix language" consistently | |||
2022-08-03 | Merge pull request #6846 from fricklerhandwerk/values | Théophane Hufschmitt | |
manual: use subheadings for primitive types | |||
2022-08-03 | Fix the html id of the list headers | Théophane Hufschmitt | |
2022-08-03 | encode primitive as list with anchors | Valentin Gagarin | |
to make it consistent with builtins and configuration options | |||
2022-08-01 | doc/distributed-builds: don't use deprecated alias | K900 | |
`nix ping-store` -> `nix store ping`. | |||
2022-07-28 | manual: use singular in body, too | Valentin Gagarin | |
Co-authored-by: Cole Helbling <cole.e.helbling@outlook.com> | |||
2022-07-28 | manual: values -> data types | Valentin Gagarin | |
2022-07-28 | manual: use singular for headings | Valentin Gagarin | |
2022-07-28 | manual: simple values -> primitives | Valentin Gagarin | |
"simple" is a loaded term | |||
2022-07-28 | manual: use subheadings for primitive types | Valentin Gagarin | |
this gives us HTML anchors for each of them | |||
2022-07-28 | manual: set -> attribute set | Valentin Gagarin | |
reword description to have shorter sentences. | |||
2022-07-28 | manual: fix section title in table of contents | Valentin Gagarin | |
2022-07-20 | Merge branch 'master' into parallel-nix-copy | Théophane Hufschmitt | |
2022-07-11 | Branch 2.10 release notes | Eelco Dolstra | |
2022-07-11 | Merge pull request #6777 from laalsaas/master | Eelco Dolstra | |
Fix logical and typographical errors in nix-env man page | |||
2022-07-11 | Update release notes | Eelco Dolstra | |
2022-07-10 | Fix logical and typographical errors in nix-env man page | laalsaas | |
2022-07-06 | Add a release notes entry for #4914 | Théophane Hufschmitt | |
cc @gytis-ivaskevicius | |||
2022-06-30 | doc: acknowledge post-rsync reality | Travis A. Everett | |
Before #5150 the copy-to-store phase of the install was idempotent, but the recursive cp isn't. This is probably baiting a few people into trying corrective installs that will fail. |