23 commits

Author	SHA1	Message	Date
Valentin Gagarin	98447c1a7f	clarify subject of sentence ... Co-authored-by: Bryan Honof <bryan.honof@tweag.io>	2022-11-09 01:29:01 +01:00
Valentin Gagarin	b5728ace5d	add articles	2022-11-09 01:29:01 +01:00
Valentin Gagarin	be8744f937	manual: architecture overview ... these changes were not merged properly and had to be reverted. see merge commit d8e54d19f7 for full history leading up to here.	2022-11-09 01:29:01 +01:00
Valentin Gagarin	d8e54d19f7	Revert "Merge pull request #6420 from nix-community/doc-what-is-nix" ... This reverts commit 81e101345f, reversing changes made to 7d1280bbaf.	2022-08-22 12:52:15 +02:00
John Ericson	39d32ac4c6	Add disclaimer that arch section is WIP and links may rot ... So we can iterate without worrying so much.	2022-08-04 14:02:58 -04:00
Valentin Gagarin	cc3a5f4ba2	use correct mdBook syntax for callouts	2022-08-04 14:04:14 +02:00
Valentin Gagarin	bac86231ad	use "build plan" consistently	2022-08-04 12:37:47 +02:00
Valentin Gagarin	b84f2bdfdd	introduce mapping to Unix files and processes	2022-08-04 12:37:47 +02:00
Valentin Gagarin	d5eea66615	introduce build tasks ... 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 12:37:47 +02:00
Valentin Gagarin	7c3bca1372	revert to build plans in top-level overview ... do not introduce build tasks yet, that is the next level of detail.	2022-08-04 12:37:47 +02:00
Valentin Gagarin	4639b36b53	use reference links for URLs	2022-08-04 12:37:47 +02:00
Valentin Gagarin	2303f84a68	revert to "build plan" in overview diagram ... this displays correct composition again. build inputs and build results are not part of build plans in terms of data objects. also this is a much less complicated setup. this will be the first impression of architecture, and we want to get it right.	2022-08-04 12:37:47 +02:00
Valentin Gagarin	25926c5fc6	Nix store does not underly literally everything ... Co-authored-by: Robert Hensing <roberth@users.noreply.github.com>	2022-08-04 12:37:47 +02:00
Valentin Gagarin	0e63b9bf88	add link from overview to store section ... the overview should only link to the three main concepts presented. the store is now fairly fleshed out. others can follow later.	2022-08-04 12:37:47 +02:00
Valentin Gagarin	ef81276cc1	architecture overview: add link to command line reference	2022-08-04 12:37:47 +02:00
Valentin Gagarin	68d26010f6	architecture overview: add link to Nix expression language reference ... update summary title to match file contents	2022-08-04 12:37:47 +02:00
Valentin Gagarin	689b32a543	clarify relation of tasks and plans	2022-08-04 12:37:47 +02:00
Valentin Gagarin	2a8532fb61	build rule -> build task ... closer to "build systems a la carte", satisfies all other complaints	2022-08-04 12:37:47 +02:00
Valentin Gagarin	902638c519	build step -> build rule ... "step" sounds atomic, while "rule" hints at internal structure, which in our case consists of mapping inputs to outputs using build instructions.	2022-08-04 12:37:47 +02:00
Valentin Gagarin	87523f01e3	match grammatical case to arrow direction	2022-08-04 12:37:47 +02:00
Valentin Gagarin	d3effd014b	update architecture diagram	2022-08-04 12:37:47 +02:00
Valentin Gagarin	610ddf44aa	reword introduction to rosetta stone, add links ... attempt to explain used and documented terminology, as well as how the declarative programming paradigm relates to building software. in the future one could highlight encouraged terms to shape future material into higher consistency.	2022-08-04 12:37:47 +02:00
Valentin Gagarin	39f01176a7	design -> architecture, add motivation ... following ideas found in Architecture of Gazelle[1] [1]: 56d35f8db0/Design.rst	2022-08-04 12:37:47 +02:00

Renamed from doc/manual/src/design/design.md (Browse further)