Valentin Gagarin
a8723671ee
Merge pull request #745 from NixOS/editorconfig
...
Add EditorConfig file and fix errors
2023-10-06 12:09:23 +02:00
Valentin Gagarin
d7556d18b1
Merge pull request #728 from g-re-g/patch-1
...
change "build task" to "derivation" in tutorial
"build task" invokes associations with pre-existing knowledge. As long as they are clearly explained, it is easier for beginners to pick up a new word than it is to add a new definition to an existing word that subtly differs from the other definitions it has. To that extent, "derivation" is probably a great word for Nix as, at least in this domain, it is very Nix specific and so, with clear definition, it should be easy to convey the idea to other folks that we are talking about something Nix specific.
2023-10-06 12:02:22 +02:00
Lorenzo Manacorda
1dcc111a4d
*: fix editorconfig errors
2023-10-06 10:59:27 +02:00
a c sreedhar reddy
f2fe0aa56b
Remove write space in shebang line ( #736 )
2023-10-03 10:12:05 +02:00
g-re-g
f381e24357
Better terminology for string interpolation of derivations
...
Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>
2023-09-14 13:00:00 -04:00
g-re-g
11f943e3b3
Remove description of derivation using "build task"
...
Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>
2023-09-14 12:59:25 -04:00
Valentin Gagarin
68839d3d60
Merge pull request #621 from CyberShadow/patch-1
...
tutorials/first-steps/nix-language: Fix the nixpkgs example
2023-09-14 15:24:30 +02:00
g-re-g
f60d8a8671
change "build task" to "derivation" in tutorial
2023-09-13 14:15:26 -04:00
Jonathan Arnett
9c7e4a8156
Use bold instead of monospace for emphasis
2023-09-02 23:17:53 -04:00
Alexander Groleau
58464f3967
fix broken anchor
2023-08-07 10:29:05 -05:00
Zach Mitchell, PhD
808ac3b3ce
Update source/tutorials/reproducible-scripts.md
...
Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>
2023-07-27 08:59:32 -06:00
Zach Mitchell, PhD
64348ea907
Update source/tutorials/reproducible-scripts.md
...
Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>
2023-07-27 08:59:32 -06:00
Alper Cugun
56ba5bda03
Explain what this construct is
...
> The chained script interpreter to be invoked
Chained is mentioned here but then also forgotten about: https://nixos.org/manual/nix/unstable/command-ref/nix-shell.html
Mostly it's unclear here why there are multiple weird hashbang lines there that are the same.
Also it's not great that here an entirely new construct is introduced that probably nobody will have ever seen before and to understand what it does you have to go to several different off-site documentation pages.
Can this be rewritten to be more standalone?
2023-07-27 08:59:32 -06:00
Tanner Wilcox
678d749e04
Update ad-hoc-shell-environments.md ( #661 )
...
Typo fix
2023-07-24 08:35:46 +01:00
Jaime Terreu
fd3494bee8
Fix small typo ( #658 )
...
Co-authored-by: Jaime Terreu <jaime@Jaimes-MacBook-Pro.local>
2023-07-21 16:25:00 +02:00
Carlos Marques
f281829318
fix mismatching file name in example ( #655 )
2023-07-20 17:59:43 +02:00
John Bowdre
21abf7b6ad
Fix typo in ad-hoc-shell-environments.md ( #652 )
...
Footnote 2: 'packges' -> 'packages'
2023-07-19 16:25:07 +01:00
Valentin Gagarin
b4628cdd04
Remove "reproducible" from glossary ( #646 )
...
* Remove "reproducible" from glossary
It is not part of the official terminology the nixos documentation team established in https://github.com/NixOS/nix.dev/pull/263 .
It was mixed in https://github.com/NixOS/nix.dev/pull/380 and messed up the official status of the terms. This change fixes that!
It can be added again when we figured out what we mean by it (https://github.com/NixOS/nix.dev/issues/464 ).
---------
Co-authored-by: davidak <davidak@users.noreply.github.com>
2023-07-13 21:33:29 +02:00
Valentin Gagarin
16ffcd0651
move estimated effort after the prerequisites
2023-07-13 21:23:23 +02:00
Valentin Gagarin
db1d3c8404
revert change of title
...
introducing a negatively connotated word is probably not a good idea.
there is some risk of inducing fear that was not there before, and the
tongue-in-cheek aspect may not come across.
the title should be unique and easy to recognise, and it was. "Reading
the Nix language" is already the title of the talk most of this is based
on, and we shouldn't reuse it
2023-07-13 21:23:23 +02:00
Valentin Gagarin
57741ca766
fix custom admonition
2023-07-13 21:23:23 +02:00
Valentin Gagarin
561ee13ffa
don't use mobile wikipedia
2023-07-13 21:23:23 +02:00
Valentin Gagarin
fc308c367e
clarify details on name assignment
...
this fills a long-standing gap of not mentioning function arguments as
another form of name assignment
2023-07-13 21:23:23 +02:00
Valentin Gagarin
633a35514c
shorten introduction
...
the allusion to the Elements of Programming[0] never really worked out
[0]: https://mitp-content-server.mit.edu/books/content/sectbyfn/books_pres_0/6515/sicp.zip/full-text/book/book-Z-H-10.html#%_sec_1.1
2023-07-13 21:23:23 +02:00
Valentin Gagarin
8f4f1936c0
rename the Nix language tutorial
...
this collapses the "don't panic" section into a motivating introduction and gives
the document a more distinctive name.
this also addresses feedback stating that having "basics" in the title
may be misleading about the effort required to work through the
tutorial.
2023-07-13 21:23:23 +02:00
alex
f8b9cae27b
fix reference link
2023-06-27 12:36:54 -05:00
alex
26e61307ad
reword parts of direnv section
2023-06-27 11:53:58 -05:00
alex
0ee2bc6371
add motivation & clarification to environment customization section
2023-06-27 11:47:20 -05:00
alex
9448dd1d0e
reword some parts of the getting started section. some bikeshedding
2023-06-27 11:42:49 -05:00
alex
c899dd4b5c
actually explain why declarative environments are useful
2023-06-27 11:39:05 -05:00
alex
1476d08634
add more contextual info to introduction
2023-06-27 11:37:16 -05:00
worktheclock
81617d94cd
Declarative reproducible developer environments
...
RITZA language edit.
2023-06-27 11:13:40 -05:00
Vladimir Panteleev
576569a9fe
Remove the nix-build line from the nixpkgs example
2023-06-27 15:08:05 +00:00
Vladimir Panteleev
f8b1d46347
Apply suggestion
...
Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>
2023-06-27 12:28:17 +00:00
Vladimir Panteleev
06328778a1
tutorials/first-steps/nix-language: Fix the nixpkgs example
2023-06-27 10:18:43 +00:00
Valentin Gagarin
1eed36a44b
add redirects for changed directory structure ( #608 )
2023-06-25 17:33:19 +02:00
i97henka
813a8ee490
making nix-direnv the default approach
2023-06-19 18:58:10 +01:00
i97henka
0773b5dc71
rebase of fzakaria pull 83
2023-06-18 10:43:38 +01:00
Valentin Gagarin
181fdc6ced
refer to Nix manual for identifier syntax ( #542 )
...
that information should not be maintained here
2023-06-08 02:19:23 +02:00
Yuki Langley
32a1c63ad9
Improve landing page ( #584 )
...
Add overview of categories, and the origin of the name Nix
2023-06-05 17:31:49 +02:00
Valentin Gagarin
53a71b0666
same statement for both laziness notes
2023-05-30 15:11:20 +02:00
Valentin Gagarin
8009e92f82
do not leave pointers to the WHNF rabbit hole
...
these details are for the reference manual
2023-05-30 15:11:20 +02:00
Robert Hensing
1106e43cc1
nix-language: Don't imply strict eval is a thing (nix-instantiate)
2023-05-30 15:11:20 +02:00
Robert Hensing
6518e7cd6b
nix-language: Don't imply strict eval is a thing
2023-05-30 15:11:20 +02:00
eunsukimme
27cdc89c18
docs: edit tutorial command line at Nested shell sessions on Ad hoc shell environment page
2023-05-14 18:55:57 +09:00
Valentin Gagarin
43b2887c3e
reword introduction to first steps tutorials
...
this more closely matches the current contents
2023-05-12 07:38:06 +02:00
Valentin Gagarin
ac5b6c2a41
clarify notes on reading files
...
placeholders were referred to before showing the example, this is probably confusing
2023-05-11 18:49:29 +02:00
Valentin Gagarin
2bc7e57227
reword note on default.nix
2023-05-11 18:40:27 +02:00
Valentin Gagarin
964b3cf2e1
update Nix version in tutorial
...
this is the one currently in nixpkgs-unstable
2023-05-11 18:39:50 +02:00
Zach Mitchell
4ed3b9ceb8
Remove nesting, add tutorial series description
2023-05-09 22:36:30 -06:00