1
0
Fork 0
mirror of https://github.com/NixOS/nix.dev.git synced 2024-10-18 14:32:43 -04:00
Commit graph

647 commits

Author SHA1 Message Date
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