aboutsummaryrefslogtreecommitdiff
path: root/doc/manual/src/introduction.md
AgeCommit message (Collapse)Author
2023-05-17Convert short nix options to long onesAlexander Schmolck
e.g. nix-env -e subversion => nix-env --uninstall subversion The aim is to make the documentation less cryptic for newcomers and the long options are more self-documenting. The change was made with the following script: <https://github.com/aschmolck/convert-short-nix-opts-to-long-ones> and sanity checked visually.
2022-11-06manual: build action -> build taskValentin Gagarin
after discussing this with multiple people, I'm convinced that "build task" is more precise: a derivation is not an action, but inert until it is built. also it's easier to pronounce. proposal: use "build task" for the generic concept "description of how to derive new files from the contents of existing files". then it will be easier to distinguish what we mean by "derivation" (a specific data structure and Nix language value type) and "store derivation" (a serialisation of a derivation into a file in the Nix store).
2021-11-17doc: De-emphasize nix-env without -AJan Tojnar
The manual uses `nix-env -i` without `-A` prominently, teaching a bad practice to newcomers.
2021-11-03Fix typosDimitris Apostolou
2020-12-31Fix `configure` error in introduction docSam Lidder
2020-07-31Enable syntax highlightingEelco Dolstra
2020-07-23Use mdbookEelco Dolstra