Commit Graph

356 Commits

Author SHA1 Message Date
Valentin Gagarin
6c903a6ccf clarify requirements of being able to read code 2022-10-04 08:34:32 +02:00
Valentin Gagarin
b0023d2ade add subsections to modes of running examples
reorder to have the REPL first (it's fewer steps)
2022-10-04 08:34:32 +02:00
Valentin Gagarin
155ad688bc explain how to read examples 2022-10-04 08:34:32 +02:00
Valentin Gagarin
6a4e69eef1 remove paths and strings from top-level outline 2022-10-04 08:34:32 +02:00
Valentin Gagarin
2406c22293 emphasize what this guide is about 2022-10-04 08:34:32 +02:00
Valentin Gagarin
61524d0d34 expressions can be nested 2022-10-04 08:34:32 +02:00
Valentin Gagarin
40ca6fc799 note on difference between antiquotation and shell vars 2022-10-04 08:34:32 +02:00
Valentin Gagarin
b3a42cffdc expand on strings and antiquotation
move section into "names and values": it should be short enough not to
exhaust readers before we get to functions, and would not make much
sense as an afterthought to functions.
2022-10-04 08:34:32 +02:00
Valentin Gagarin
ca37fe15b0 regularize function examples 2022-10-04 08:34:32 +02:00
Valentin Gagarin
43f2895b2c add counter-example to attribute set argument 2022-10-04 08:34:32 +02:00
Valentin Gagarin
23b52d351e add subsection heading 2022-10-04 08:34:32 +02:00
Valentin Gagarin
560268d865 add missing colon 2022-10-04 08:34:32 +02:00
Valentin Gagarin
9015962289 make example explicit 2022-10-04 08:34:32 +02:00
Valentin Gagarin
c6a1c90bbf tighter inherit notation 2022-10-04 08:34:32 +02:00
Valentin Gagarin
db56937ab3 add developer tools to skills outline 2022-10-04 08:34:31 +02:00
Valentin Gagarin
075df5b67b give language properties more structure 2022-10-04 08:34:31 +02:00
Valentin Gagarin
41250bb231 reorder first sentences 2022-10-04 08:34:31 +02:00
Valentin Gagarin
92e6e2341e add dynamic typing 2022-10-04 08:34:31 +02:00
Valentin Gagarin
80b0dcb8ae expand on single function argument 2022-10-04 08:34:31 +02:00
Valentin Gagarin
fa674e3e11 restructure introduction 2022-10-04 08:34:31 +02:00
Valentin Gagarin
e5d41c8425 remove word repetition 2022-10-04 08:34:31 +02:00
Valentin Gagarin
3f3a2a432f add recommendaton to search paths 2022-10-04 08:34:31 +02:00
Valentin Gagarin
cda602d3fb restructure examples 2022-10-04 08:34:31 +02:00
Valentin Gagarin
4d65ecf82c WIP: side effects 2022-10-04 08:34:31 +02:00
Valentin Gagarin
388e658437 break up long sentence 2022-10-04 08:34:31 +02:00
Valentin Gagarin
339320ffa1 restructure headings
this will have a nicer display in the table of contents
2022-10-04 08:34:31 +02:00
Valentin Gagarin
0c7c1eb594 everyone calls them side effects 2022-10-04 08:34:31 +02:00
Valentin Gagarin
76561aa33a add structure to config example 2022-10-04 08:34:31 +02:00
Valentin Gagarin
f5439cdbc4 expand shell example 2022-10-04 08:34:31 +02:00
Valentin Gagarin
67b5187a30 clarify outline 2022-10-04 08:34:31 +02:00
Valentin Gagarin
ca66ac9a6a guide -> direct 2022-10-04 08:34:31 +02:00
Valentin Gagarin
573586b684 prerequisites: programming languages -> software development 2022-10-04 08:34:31 +02:00
Valentin Gagarin
7f6404c1ae restructure intro to functions 2022-10-04 08:34:31 +02:00
Valentin Gagarin
ceff1d7713 json example: set -> object 2022-10-04 08:34:31 +02:00
Valentin Gagarin
678d3ce737 restrucutre note on . and .. paths 2022-10-04 08:34:31 +02:00
Valentin Gagarin
c510aeb295 show example passing an attrset 2022-10-04 08:34:31 +02:00
Valentin Gagarin
f3e192e3b8 add note on ./. syntax 2022-10-04 08:34:31 +02:00
Valentin Gagarin
5a638c5ed8 fix grammar and typo 2022-10-04 08:34:31 +02:00
Valentin Gagarin
f1c90cdda5 function call: argument -> operand 2022-10-04 08:34:31 +02:00
Valentin Gagarin
f6ad05bf24 comment out missing links 2022-10-04 08:34:31 +02:00
Valentin Gagarin
4273dc987f tutorial -> guide 2022-10-04 08:34:31 +02:00
Valentin Gagarin
c0ca352c83 remove trivial builders from libraries
they really belong to generic build mechanisms, and we will not cover
them here.
2022-10-04 08:34:31 +02:00
Valentin Gagarin
d16b6fcf72 add section on libraries 2022-10-04 08:34:31 +02:00
Valentin Gagarin
c7729502bc remove description of language properties
this should be in the Nix manual
2022-10-04 08:34:31 +02:00
Valentin Gagarin
c0b0c2ba32 add link to Nix Pills 2022-10-04 08:34:31 +02:00
Valentin Gagarin
354f8cba72 add aka @ pattern 2022-10-04 08:34:31 +02:00
Valentin Gagarin
cb14464be1 reword intro to inherit 2022-10-04 08:34:31 +02:00
Valentin Gagarin
ef5f3823cc uniform format for code samples 2022-10-04 08:34:31 +02:00
Valentin Gagarin
e4bfdf0707 add overview on what using Nix language entails
inspired by https://news.ycombinator.com/item?id=32364899
2022-10-04 08:34:30 +02:00
Valentin Gagarin
5bc7fa3ebb expand NixOS config example 2022-10-04 08:34:30 +02:00