nix.dev/source/tutorials/index.md

(tutorials)=
# Tutorials

These sections contains series of lessons to get started.

```{toctree}
:glob:
:maxdepth: 2

first-steps/index.md
nix-language.md
Packaging existing software <packaging-existing-software.md>
file-sets.md
nixos/index.md
cross-compilation.md
module-system/module-system.md
```
Make home page cards clickable (#616) 2023-06-25 08:13:20 -04:00			`(tutorials)=`
			`# Tutorials`

			`These sections contains series of lessons to get started.`

			```{toctree}
			`:glob:`
			`:maxdepth: 2`

			`first-steps/index.md`
move Nix language tutorial to top level this fits the global outline we developed, and also makes the tutorial more immediately visible - working with the Nix language is a core skill we want to teach after all 2023-10-09 11:26:06 -04:00			`nix-language.md`
dissolve the Learning Journey section This does not yet follow #701, because the change to get there would be too big. The goal is to keep the table of contents meaningful at all times and the diff of each pull request manageable. The packaging tutorial is quite important, so it's not wrong to have it visible on the front page until we have enough material for a packaging section. The sharing dependencies article should really be a very brief guide, but because that would be quite a big change, it's only moved to the Guides section for now. 2023-10-26 23:26:59 -04:00			`Packaging existing software <packaging-existing-software.md>`
File sets tutorial (#802) * source file selection tutorial Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io> Co-authored-by: Robert Hensing <roberth@users.noreply.github.com> 2023-11-23 11:14:46 -05:00			`file-sets.md`
Make home page cards clickable (#616) 2023-06-25 08:13:20 -04:00			`nixos/index.md`
			`cross-compilation.md`
Module system deep dive tutorial (#645) * Draft module system introduction tutorial * add intro/conclusion, rework prose, follow styleguide, clean diffs * Review pass * Apply suggestions from code review * fix whitespace * add some more motivation the each section * make scripts downloadable * address review comments * make script actually work ...hopefully. can't test it without Google API key * add file watching yes, this looks scary, and yes, it works. * update diff and wording * more notes on potential pitfalls * be explicit which `map` we mean * split nullable from default values * also wrap the geocode script * work through the tutorial to the end * add tutorial overview * `lib` is always passed * add separate section for `evalModules` and fix link * make option strucutre more self-explanatory * explain command line invocations * add note on incomplete reference documentation * add more highlight to the `config` distinction * fix parameter passing to the `./map` script * fix typo * fix wording * link to summer of nix * add missing word * link to Google Maps API docs * more explicit requirement * use correct module system terminology * Update source/tutorials/module-system/module-system.md * Apply suggestions from code review * whitespace * module-system.md: replace comments with captions * add missing lang for code-block * Update module system title * change most headers to be about module features (#797) * change most headers to be about module features Some headers could not be made about module features, and that's a strong signal that those sections should be removed. * Apply suggestions from code review * module-system.md: Fix header casing Co-authored-by: Alexander Groleau <source@proof.construction> Co-authored-by: asymmetric <lorenzo@mailbox.org> Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io> 2023-11-20 11:21:06 -05:00			`module-system/module-system.md`
Make home page cards clickable (#616) 2023-06-25 08:13:20 -04:00			```