Henrik
dd2d348513
Update source/contributing/documentation.md
...
Co-authored-by: Alexander Groleau <alex@proof.construction>
2023-07-17 16:24:22 +01:00
Henrik
056d4f2938
Update source/contributing/documentation.md
...
Co-authored-by: Alexander Groleau <alex@proof.construction>
2023-07-17 16:24:05 +01:00
Henrik
e0677bc570
Update source/contributing/documentation.md
...
Co-authored-by: Alexander Groleau <alex@proof.construction>
2023-07-17 16:23:53 +01:00
i97henka
23c5bade2a
adding how to help on pills.
2023-07-17 16:16:26 +01:00
Henrik
b1756bd187
Update source/contributing/documentation.md
...
Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>
2023-07-17 16:05:07 +01:00
i97henka
10b936f6d8
adding nix pills to external sources.
2023-07-16 12:55:17 +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
1fce49476d
Merge pull request #609 from NixOS/language-tutorial-title
...
Nix language tutorial: restructure introduction
2023-07-13 21:26:57 +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
Zach Mitchell, PhD
09a38eeb3f
Merge branch 'master' into skeleton-workflow
2023-07-13 06:58:37 -06:00
Zach Mitchell
2592019afc
Fix more broken links
2023-07-13 06:57:31 -06:00
Zach Mitchell
614e04fe81
Fix broken link
2023-07-13 06:57:31 -06:00
Zach Mitchell
a3d9c019b1
Merge writing-style and style-guide
2023-07-13 06:57:31 -06:00
Zach Mitchell
00348edd0c
Add style guide
2023-07-13 06:57:31 -06:00
Zach Mitchell
9a6309c492
Add learning journey contribution guidelines
2023-07-13 06:57:31 -06:00
alex
2b1a05bcc3
fix boot config, correctly enable wlan firmware, update config link
2023-07-11 16:26:53 -05:00
proofconstruction
97112eb558
Update Raspberry Pi Installing NixOS Tutorial ( #641 )
2023-07-10 23:09:59 +02:00
alex
45c9382551
fix broken bob build link
2023-07-09 13:48:05 -05:00
Yuki Langley
ca0dc99eb6
Ignore linkcheck on GitHub file viewer/browser
...
This is done in order to unbreak CI until a proper solution is found.
Related to https://github.com/NixOS/nix.dev/issues/631
2023-07-07 17:47:55 +07:00
asymmetric
a119476444
Change project's self-description ( #575 )
...
nix.dev is now official
Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>
2023-07-04 19:11:43 +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
Aaron Bennett
6d7bee54c5
Fix typo ( #619 )
...
Remove trailing backtick.
2023-06-27 00:12:38 +02:00
Valentin Gagarin
09cf170b0a
fix wording
2023-06-26 17:26:31 +02:00
Valentin Gagarin
33820f5751
why are flakes controversial ( #546 )
...
* concept: why are flakes controversial
2023-06-26 17:07:31 +02:00
Valentin Gagarin
1eed36a44b
add redirects for changed directory structure ( #608 )
2023-06-25 17:33:19 +02:00
Yuki Langley
145158825d
Generate 404.html ( #617 )
2023-06-25 17:23:09 +02:00
Yuki Langley
9aaa97a8b0
Make home page cards clickable ( #616 )
2023-06-25 14:13:20 +02:00
Yuki Langley
d426269f96
conf.py: Update repository url and branch ( #613 )
2023-06-24 14:54:09 +02:00
Valentin Gagarin
2ae6b07a97
move more writing style recommendations into the public guide ( #607 )
2023-06-22 11:18:22 +02:00
Valentin Gagarin
9c3e6c54fe
Merge pull request #597 from henrik-ch/nix-direnv
...
rebase of fzakaria pull request 83
2023-06-20 11:01:07 +02:00
i97henka
813a8ee490
making nix-direnv the default approach
2023-06-19 18:58:10 +01:00
alex
0c933bd9e8
Move writing style to separate page
2023-06-19 11:25:29 -05:00
i97henka
0773b5dc71
rebase of fzakaria pull 83
2023-06-18 10:43:38 +01:00
Valentin Gagarin
983ab67907
use "name" instead of "variable" consistently ( #588 )
...
strictly speaking, the Nix language does not have variables because what we call "variables" in the mathematical sense are names assigned to values that do not change, but can rather have different possible but fixed values depending on context.
this change is mainly to make use of words consistent with the Nix language tutorial in order to avoid any ambiguity and confusion for beginners, who may wonder why one article says "there are no variables" and the other one liberally uses the term regardless. always using "name" makes unmistakably clear that it's a variable in the mathematical sense.
2023-06-13 21:45:42 +02:00
asymmetric
a094ffe818
css: fix code box colors ( #595 )
2023-06-12 00:08:41 +02: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
Valentin Gagarin
0ca05fd6dc
glossary: add links to manuals and source code ( #550 )
2023-06-08 02:18:51 +02:00
Yuki Langley
c4c366160e
Add Nix snowflake logo ( #585 )
...
* Add Nix snowflake logo to sidebar
* Add Nix snowflake favicon
Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>
2023-06-07 10:41:40 +02:00