NixOS/nix.dev
NixOS/nix.dev
1
0
Fork 0
mirror of https://github.com/NixOS/nix.dev.git synced 2024-10-18 14:32:43 -04:00
Code Activity
1689 commits 15 branches 0 tags 6.2 MiB
Commit graph

1008 commits

Author SHA1 Message Date
Valentin Gagarin 7278371717
Merge pull request #305 from olafklingt/update-only-testing 
expand on nixos configuration testing
 2023-09-11 15:24:51 +02:00
Valentin Gagarin 2bcb9da7c3
fix cross-link 2023-09-11 15:19:24 +02:00
Valentin Gagarin 668d318fe3
add technical detail 
hopefully not too much
 2023-09-11 15:17:16 +02:00
Valentin Gagarin 2955e01632
update note on macOS 2023-09-11 15:15:14 +02:00
Valentin Gagarin 2dfe03711d
add keyword 2023-09-11 15:14:15 +02:00
Valentin Gagarin 7a681b98ef
wording and links 2023-09-11 15:13:00 +02:00
Valentin Gagarin bfb1858a51
formatting and consistency 2023-09-11 15:08:42 +02:00
olaf 2fed480cdd pkgs = import nixpkgs {config = {}; overlays = [];}; 2023-09-11 12:22:30 +02:00
olaf 73486dd8f1 simplify used parts of default configuration.nix 
move Re-run successful tests into a detais section.
 2023-09-11 11:49:20 +02:00
Valentin Gagarin 22eb5a350a
reword and add links 
use a uniform phrasing
 2023-09-11 11:44:33 +02:00
olaf 05a570cfd5 fix title of testing vm tutorial 2023-09-11 10:59:55 +02:00
olaf 44333f7fb4 fix references heading in vm tutorial 2023-09-11 10:59:13 +02:00
olaf 5ae9aba3a5 reorder tutorials in nixos index 2023-09-11 10:56:28 +02:00
wamirez 5a35595308 added new category 'troubleshooting' and moved 4 faqs to it 2023-09-11 00:13:51 -04:00
olaf 6a2a3e49de functionality of nixpkgs 2023-09-10 22:54:59 +02:00
olaf 82b206d031 fix link warning 2023-09-10 22:44:16 +02:00
olaf 9461c93af1 first reactions to comments 2023-09-10 22:24:20 +02:00
olaf 1fe25c832f Apply suggestions from code review 
Co-authored-by: Silvan Mosberger <github@infinisil.com>
 2023-09-10 22:23:47 +02:00
olaf 97ba15ed48 comment ref to not merged tutorial 2023-09-10 22:23:41 +02:00
olaf 62145d03d5 Apply suggestions from @fricklerhandwerk 
Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>
 2023-09-10 22:23:31 +02:00
olaf 691e4636d0 expand on nixos configuration testing 
use of fricklerhandwerks review of integration test
 2023-09-10 22:23:04 +02:00
Valentin Gagarin 50007ff30b nest documentation stuff one level deeper 2023-09-07 12:06:29 +02:00
Valentin Gagarin eda059a1c9 move diataxis summary to separate page 2023-09-07 12:06:29 +02:00
Alexander Groleau 761d7de5e2
fix typo in contributing documentation 2023-09-06 13:12:30 -05:00
Yuki Langley e79528b227
Clean-up FAQ (#705) 2023-09-04 20:21:24 +02:00
Jonathan Arnett 9c7e4a8156
Use bold instead of monospace for emphasis 2023-09-02 23:17:53 -04:00
Valentin Gagarin 783913c8cd
highlight call for donations (#703) 2023-08-29 21:07:48 +02:00
Zach Mitchell b038f6e117 Update sharing deps tutorial 2023-08-28 11:17:07 -06:00
Zach Mitchell, PhD bc863f7f85
Merge pull request #675 from zmitchell/sharing-deps-tutorial 2023-08-25 21:34:04 -06:00
Alexander Groleau 830da4b49e
Merge pull request #694 from DeterminateSystems/magic-nix-cache 
Add the Magic Nix Cache as an option to the GitHub Actions page
 2023-08-25 19:43:13 -05:00
Graham Christensen c703c92234
Apply review nits 
Co-authored-by: Alexander Groleau <alex@proof.construction>
 2023-08-25 20:31:20 -04:00
Graham Christensen 3fbc19b874
Add the Magic Nix Cache as an option to the GitHub Actions page 
Not sure if this is the right place for it, but it seemed like the most direct place to add it.
I'm open to other suggestions as well.
 2023-08-24 14:44:36 -04:00
Valentin Gagarin 73b928d5e4
fix typo 2023-08-24 18:27:54 +02:00
Valentin Gagarin 458acd70b2
add missing word 2023-08-24 18:25:23 +02:00
Alexander Groleau 92e4e1e26b
remove regex that breaks copy button (#690) 2023-08-24 10:21:22 +02:00
Zach Mitchell 8c6a172b03 Explain the shell attribute 2023-08-23 22:12:05 -06:00
Zach Mitchell 4b97c6b88e Update with review comments 2023-08-23 22:08:28 -06:00
Zach Mitchell 19be694d6b Add sharing deps tutorial 2023-08-23 21:44:55 -06:00
Frenco fb0f26838e
Update best-practices.md (#689) 2023-08-23 22:21:22 +02:00
Lorenzo Manacorda cf754d4f27 conf.py: enable line numbes for nix, python code 2023-08-18 15:04:39 +02:00
Zach Mitchell b4651ec6d5 tweak shell.nix tutorial 2023-08-16 18:14:05 -06:00
Alexander Groleau 818d33c7df add instructions for enabling hardware graphics acceleration 2023-08-14 15:10:44 -05:00
Alexander Groleau d3ae1080e9
Merge pull request #634 from zmitchell/diataxis-explanation 
Add a summary of the Diataxis framework
 2023-08-11 13:34:00 -05:00
Alexander Groleau 6bd4567302 recommend nix-locate/nix-index 2023-08-10 10:45:03 -05:00
Alexander Groleau 7c950a309e remove name error encounter 2023-08-10 10:45:03 -05:00
Alexander Groleau f1fb505398 Update source/tutorials/learning-journey/packaging-existing-software.md 
Co-authored-by: Zach Mitchell, PhD <zmitchell@fastmail.com>
 2023-08-10 10:45:03 -05:00
Alexander Groleau b9056f6d3a Update source/tutorials/learning-journey/packaging-existing-software.md 
Co-authored-by: Zach Mitchell, PhD <zmitchell@fastmail.com>
 2023-08-10 10:45:03 -05:00
Alexander Groleau 8e38972d40 Update source/tutorials/learning-journey/packaging-existing-software.md 
Co-authored-by: Zach Mitchell, PhD <zmitchell@fastmail.com>
 2023-08-10 10:45:03 -05:00
Alexander Groleau 06285c2e72 Update source/tutorials/learning-journey/packaging-existing-software.md 
Co-authored-by: Silvan Mosberger <github@infinisil.com>
 2023-08-10 10:45:03 -05:00
Alexander Groleau 582553cf3c Update source/tutorials/learning-journey/packaging-existing-software.md 
Co-authored-by: Zach Mitchell, PhD <zmitchell@fastmail.com>
 2023-08-10 10:45:03 -05:00
Alexander Groleau 7a9199115f Update source/tutorials/learning-journey/packaging-existing-software.md 
Co-authored-by: Zach Mitchell, PhD <zmitchell@fastmail.com>
 2023-08-10 10:45:03 -05:00
Alexander Groleau c714c04a60 Update source/tutorials/learning-journey/packaging-existing-software.md 
Co-authored-by: Zach Mitchell, PhD <zmitchell@fastmail.com>
 2023-08-10 10:45:03 -05:00
Alexander Groleau 2ab3c4b4ad Update source/tutorials/learning-journey/packaging-existing-software.md 
Co-authored-by: Zach Mitchell, PhD <zmitchell@fastmail.com>
 2023-08-10 10:45:03 -05:00
Alexander Groleau 42cf37cd43 Update source/tutorials/learning-journey/packaging-existing-software.md 
Co-authored-by: Zach Mitchell, PhD <zmitchell@fastmail.com>
 2023-08-10 10:45:03 -05:00
Alexander Groleau b374799ca2 Update source/tutorials/learning-journey/packaging-existing-software.md 
Co-authored-by: Zach Mitchell, PhD <zmitchell@fastmail.com>
 2023-08-10 10:45:03 -05:00
Alexander Groleau 2ace3c6e1c Update source/tutorials/learning-journey/packaging-existing-software.md 
Co-authored-by: Zach Mitchell, PhD <zmitchell@fastmail.com>
 2023-08-10 10:45:03 -05:00
Alexander Groleau 37f5fd3030 Update source/tutorials/learning-journey/packaging-existing-software.md 
Co-authored-by: Zach Mitchell, PhD <zmitchell@fastmail.com>
 2023-08-10 10:45:03 -05:00
Alexander Groleau 4ed39f5eff Update source/tutorials/learning-journey/packaging-existing-software.md 
Co-authored-by: Zach Mitchell, PhD <zmitchell@fastmail.com>
 2023-08-10 10:45:03 -05:00
Alexander Groleau 8998be56e4 Update source/tutorials/learning-journey/packaging-existing-software.md 
Co-authored-by: Zach Mitchell, PhD <zmitchell@fastmail.com>
 2023-08-10 10:45:03 -05:00
Alexander Groleau a7af180486 Update source/tutorials/learning-journey/packaging-existing-software.md 
Co-authored-by: Zach Mitchell, PhD <zmitchell@fastmail.com>
 2023-08-10 10:45:03 -05:00
Alexander Groleau 24fba428cb Update source/tutorials/learning-journey/packaging-existing-software.md 
Co-authored-by: Zach Mitchell, PhD <zmitchell@fastmail.com>
 2023-08-10 10:45:03 -05:00
Alexander Groleau 7ede9c5115 Update source/tutorials/learning-journey/packaging-existing-software.md 
Co-authored-by: Zach Mitchell, PhD <zmitchell@fastmail.com>
 2023-08-10 10:45:03 -05:00
Alexander Groleau 1ccaedafd0 one sentence per line 2023-08-10 10:45:03 -05:00
Alexander Groleau 9ae846d325 remove unnecessary console output 2023-08-10 10:45:03 -05:00
Alexander Groleau a0d5460989 no longer using dev output of libX11 2023-08-10 10:45:03 -05:00
Alexander Groleau f8f420ddb5 remove pkgs from args 2023-08-10 10:45:03 -05:00
Alexander Groleau 50912fa0a0 replace fetchTarball with fetchzip 2023-08-10 10:45:03 -05:00
Alexander Groleau 55b8bfaec4 remove discussion of command line expression argument 2023-08-10 10:45:03 -05:00
Alexander Groleau 83abf61e38 remove unnecessary title 2023-08-10 10:45:03 -05:00
Alexander Groleau 3a16fb2f8d replace tabs with spaces 2023-08-10 10:45:03 -05:00
Alexander Groleau 1069b54440 Update source/tutorials/learning-journey/packaging-existing-software.md 
Co-authored-by: Silvan Mosberger <github@infinisil.com>
 2023-08-10 10:45:03 -05:00
Alexander Groleau d2fe900b39 Update source/tutorials/learning-journey/packaging-existing-software.md 
Co-authored-by: Silvan Mosberger <github@infinisil.com>
 2023-08-10 10:45:03 -05:00
Alexander Groleau 3e7fa59b33 Update source/tutorials/learning-journey/packaging-existing-software.md 
Co-authored-by: Silvan Mosberger <github@infinisil.com>
 2023-08-10 10:45:03 -05:00
Alexander Groleau 6fc7875904 Update source/tutorials/learning-journey/packaging-existing-software.md 
Co-authored-by: Silvan Mosberger <github@infinisil.com>
 2023-08-10 10:45:03 -05:00
Alexander Groleau 8e9a37cb0b Update source/tutorials/learning-journey/packaging-existing-software.md 
Co-authored-by: Silvan Mosberger <github@infinisil.com>
 2023-08-10 10:45:03 -05:00
Alexander Groleau 6bf8b0ef93 Update source/tutorials/learning-journey/packaging-existing-software.md 
Co-authored-by: Silvan Mosberger <github@infinisil.com>
 2023-08-10 10:45:03 -05:00
Alexander Groleau 3bb3ebe147 Update source/tutorials/learning-journey/packaging-existing-software.md 
Co-authored-by: Silvan Mosberger <github@infinisil.com>
 2023-08-10 10:45:03 -05:00
Alexander Groleau 9da83aab68 Update source/tutorials/learning-journey/packaging-existing-software.md 
Co-authored-by: Silvan Mosberger <github@infinisil.com>
 2023-08-10 10:45:03 -05:00
Alexander Groleau 5184c89824 Update source/tutorials/learning-journey/packaging-existing-software.md 
Co-authored-by: Silvan Mosberger <github@infinisil.com>
 2023-08-10 10:45:03 -05:00
Alexander Groleau beef4414ab Update source/tutorials/learning-journey/packaging-existing-software.md 
Co-authored-by: Silvan Mosberger <github@infinisil.com>
 2023-08-10 10:45:03 -05:00
Alexander Groleau 554aeec5cb Update source/tutorials/learning-journey/packaging-existing-software.md 
Co-authored-by: Silvan Mosberger <github@infinisil.com>
 2023-08-10 10:45:03 -05:00
Alexander Groleau d73c0c7979 move packaging existing software to learning journey 2023-08-10 10:44:50 -05:00
Alexander Groleau 34d55f8ecc update learning journey index 2023-08-10 10:43:51 -05:00
Alexander Groleau a7a245be62 only use 4 spaces, no tabs 2023-08-10 10:42:45 -05:00
Alexander Groleau 475ec56b15 update console output 2023-08-10 10:42:45 -05:00
Alexander Groleau bbacf0d839 add pkgs argument again 2023-08-10 10:42:45 -05:00
Alexander Groleau 0b8f525a94 use default.nix workflow 2023-08-10 10:42:45 -05:00
Alexander Groleau ac3ab131fb don't introduce pkgs argument too soon 2023-08-10 10:42:45 -05:00
Alexander Groleau b315ef64fd stop using royal we 2023-08-10 10:42:45 -05:00
Alexander Groleau 388806960f make skeleton derivation smaller 2023-08-10 10:42:45 -05:00
Alexander Groleau 8762a1c6f9 convert section on "package" term to note 2023-08-10 10:42:45 -05:00
Alexander Groleau e4930ffe1a mkDerivation tutorial doesn't exist yet 2023-08-10 10:42:45 -05:00
Alexander Groleau 03d6e30d12 "package" as derivation result 2023-08-10 10:42:45 -05:00
alex 20ae449be7 improve clarity and precision 2023-08-10 10:42:45 -05:00
alex d8066b64e7 better motivate custom installPhase 2023-08-10 10:42:45 -05:00
alex a0091bac24 improve discussion of phase hooks 2023-08-10 10:42:45 -05:00
alex 44d8c15f3e expand section on adding Xlib dependency 2023-08-10 10:42:45 -05:00
alex 4f6d0fa176 improve end of icat packaging, add ls output 2023-08-10 10:42:45 -05:00
alex f1dcba406d remove section building package without phase hooks 2023-08-10 10:42:45 -05:00
alex 12e41e3a40 remove contributing, metadata, and devshell sections 2023-08-10 10:42:45 -05:00
alex f17f33ec69 pkg-config no longer needed 2023-08-10 10:42:45 -05:00
alex 5ee2b986c9 remove description of nixpkgs import/callPackage expression 2023-08-10 10:42:45 -05:00
alex 319593ae83 shorten some derivation examples and fix whitespace 2023-08-10 10:42:45 -05:00
alex 5f6280bb39 different source means different console output 2023-08-10 10:42:45 -05:00
alex 42562620f3 use nix-prefetch-url earlier 2023-08-10 10:42:45 -05:00
alex a4233f2d8b use latest release instead of master 2023-08-10 10:42:45 -05:00
alex c70df9511c move dependencies to derivation inputs, because we use callPackage 2023-08-10 10:42:45 -05:00
alex 0797d1cd4e remove namespace errors 2023-08-10 10:42:45 -05:00
alex a1eea0bf77 the stdenv is doing the work, not nix itself 2023-08-10 10:42:45 -05:00
alex e88e060e67 let the manual more-verbosely explain fetchFromGitHub arguments 2023-08-10 10:42:45 -05:00
alex f1d6bf20bd note what callPackage does 2023-08-10 10:42:45 -05:00
alex bbb4a130b6 use lib.fakeSha256 instead of a string of 53 zeroes 2023-08-10 10:42:45 -05:00
alex 77daebd127 rephrase fetchTarball introduction 2023-08-10 10:42:45 -05:00
alex ce6bd9a913 add explanation of what "package" means here 2023-08-10 10:42:45 -05:00
alex 0a211946de remove contributing to nixpkgs section 2023-08-10 10:42:45 -05:00
alex 0c2c29e27d mention that the stdenv automates a lot of this 2023-08-10 10:42:45 -05:00
alex 62ea6335c3 add draft of packaging existing software tutorial 2023-08-10 10:42:45 -05:00
Zach Mitchell, PhD 31f269d2d9
Merge pull request #671 from zmitchell/shell-tutorial 
Add shell.nix tutorial
 2023-08-10 09:23:52 -06:00
Zach Mitchell 56429a2b66 Update with docs team review 2023-08-10 09:20:30 -06:00
Zach Mitchell 248a0bf6f8 Update with review comments 2023-08-10 07:42:49 -06:00
Zach Mitchell 35c1df9789 Update with review comments 2023-08-09 22:34:44 -06:00
Zach Mitchell a096fdce5c Add a summary of the Diataxis framework 2023-08-09 22:34:42 -06:00
Zach Mitchell a0a4cd8968 Update with review comments 2023-08-09 22:06:21 -06:00
Alexander Groleau 9b7686e41b fix broken link to experimental-features 2023-08-08 13:42:15 -05:00
Alexander Groleau 58464f3967 fix broken anchor 2023-08-07 10:29:05 -05:00
Zach Mitchell 5b29e71e43 Add shell.nix tutorial 2023-08-02 21:57:38 -06:00
Yuki Langley ca9b433e1a Add styles for diffs 
Closes https://github.com/NixOS/nix.dev/issues/644
 2023-08-02 12:08:25 +07:00
Jeremy fd9c34b940
Clarify and fix grammar/spelling mistakes in the installation guide for the Pi (#667) 2023-08-01 20:49:32 +02:00
Yuki Langley c7f17eb77e
Update diataxis links (#669) 2023-08-01 11:40:40 +02:00
Michael Smith f4d6f239a7
Update faq.md (#666) 2023-07-28 23:27:17 +02: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
Zach Mitchell, PhD 2781cb48a7
Merge pull request #664 from zmitchell/fix-diataxis-link 
Fix broken Diataxis links
 2023-07-27 08:57:59 -06:00
Zach Mitchell ba3104a14b Fix broken Diataxis links 2023-07-27 08:45:51 -06:00
Zach Mitchell, PhD 6e69e3049c
Merge pull request #547 from fricklerhandwerk/faq-flakes-enable 
FAQ: should I enable flakes
 2023-07-27 08:11:45 -06:00
Zach Mitchell, PhD ac9d66cc0d
Merge pull request #653 from fricklerhandwerk/contributing 
expand contribution guidelines
 2023-07-27 08:09:41 -06:00
Silvan Mosberger 395ae61d71
Merge pull request #659 from henrik-ch/fix-non-NixOS 
small touch-up - removing non-NixOS referral
 2023-07-27 16:06:51 +02:00
Tanner Wilcox 678d749e04
Update ad-hoc-shell-environments.md (#661) 
Typo fix
 2023-07-24 08:35:46 +01:00
Henrik 27ec931631
Update installing-nixos-on-a-raspberry-pi.md 
removing non-NixOS reference
 2023-07-21 19:30:39 +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
Valentin Gagarin 03e49423d1
fix typos, remove superfluous ellipses 2023-07-21 11:36:25 +02:00
Valentin Gagarin def3fbd071 add pointers for making donations 2023-07-21 09:32:41 +02:00
Valentin Gagarin 875cb4ae06 expand contribution guidelines 
in particular, give more concrete tips on filing issues.
this is based on experience with helping to maintain Nix and trying to make
sense of what's going on in Nixpkgs.
 2023-07-21 09:32:41 +02:00
i97henka a0c388342e adding note about using etcher when on non-nixos system. 2023-07-20 18:21:23 +01:00
Carlos Marques f281829318
fix mismatching file name in example (#655) 2023-07-20 17:59:43 +02:00
Valentin Gagarin 239f0607ea strip trailing whitespace 2023-07-20 15:15:02 +02:00
Valentin Gagarin ea9def69c7 fix typos 2023-07-20 15:14:35 +02:00
Valentin Gagarin b5a568c57e
fix typo 2023-07-20 13:44:29 +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
Alexander Groleau faf2023d93
Merge pull request #649 from henrik-ch/639_pills_externalsources 
adding nix pills to external sources.
 2023-07-17 10:28:43 -05:00
Henrik 2c3083cf32
Update source/contributing/documentation.md 
Co-authored-by: Alexander Groleau <alex@proof.construction>
 2023-07-17 16:25:45 +01:00
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
Alexander Groleau adcb1a0d99
Merge pull request #648 from gerbrent/patch-1 
correct dd command, removing .zst from if=*.img.zst
 2023-07-17 09:28:04 -05:00
Valentin Gagarin d49aed6039
remove collection of software Nix has influenced (#295) 
this is marketing material and should not be in the responsibility of
documentation maintainers to curate.
 2023-07-17 15:19:13 +01:00
Brent Gervais d93129b5ba
correct dd command, removing .zst from if=*.img.zst 
the command to image the SD card included `if=nixos-sd-image-......img.zst` though the intention here is to write the non-compressed image to the SD, not the compressed zst image.

.img.zst > .img

As written this command would not function as intended.
 2023-07-16 09:45:57 -06: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
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
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 dcdb26075d
fix wording 
Co-authored-by: Zach Mitchell, PhD <zmitchell@fastmail.com>
 2023-06-15 04:55:11 +02: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
Yuki Langley 793206a5e6
Fix invalid sitemap (#586) 2023-06-06 10:15:53 +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
Yuki Langley 6f9bad97b1
Add robots.txt (#583) 2023-06-05 03:02:31 +02:00
asymmetric a1d1ce5a98
Merge pull request #562 from NixOS/no-sponsors 
Remove mention of corporate sponsors
 2023-06-01 11:44:25 +02:00
asymmetric ba16b1f4fc
Update source/acknowledgments/sponsors.md 
Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>
 2023-06-01 09:42:01 +00:00
Valentin Gagarin 022188349d
concept: what are flakes (#545) 
* concept: what are flakes
 2023-06-01 10:59:29 +02:00
asymmetric bfd57a67bb
Merge pull request #576 from NixOS/bump-deps 
Bump Sphinx and theme
 2023-06-01 10:53:05 +02:00
Valentin Gagarin 0bd24f7408
update contribution guide concerning the wiki 2023-05-31 02:18:55 +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
Lorenzo Manacorda 0d860e87c5 sponsors: Add link to OpenCollective 2023-05-30 13:24:33 +02:00
Lorenzo Manacorda 65f7ca6387 sponsors: Add context before sponsors 2023-05-30 13:24:33 +02:00
Lorenzo Manacorda 687c1037d2 Fix config error 
Newer Sphinx doesn't accept None, so leaving default of 'en'.
 2023-05-29 11:58:25 +02:00
Lorenzo Manacorda 52b6f2d22e Fix cachix link 2023-05-29 10:05:17 +02:00
Lorenzo Manacorda 49249e53a4 Remove sponsors from sidebar 2023-05-29 10:03:59 +02:00
Raphael Das Gupta 41ab7e1ee0
write "GitHub" with a uppercase "H" (#574) 2023-05-29 07:31:14 +01:00
Lorenzo Manacorda d65308e6bd Remove sponsors from footer 2023-05-28 19:44:52 +02:00
Valentin Gagarin a8d640e6c6
Merge pull request #548 from fricklerhandwerk/language-pitfalls 
turn anti-patterns into best practices
 2023-05-25 16:52:10 +02:00
Lorenzo Manacorda 226cbfcfd5 link sponsors in footer 2023-05-25 13:03:23 +02:00
Lorenzo Manacorda 789897562d add sponsors page 2023-05-25 13:02:47 +02:00
Lorenzo Manacorda 544a3de332 Sponsors -> Acknowledgments 2023-05-25 13:02:22 +02:00
Lorenzo Manacorda d993a7f59c Revert "Remove mention of corporate sponsors" 
This reverts commit bbad27ea9fa8aba79151704bd73438d78eba4ea5.

We're going to mention past sponsors.
 2023-05-25 13:02:22 +02:00
Lorenzo Manacorda 9a16562f0a Remove mention of corporate sponsors 
Now that the site is owned by the foundation.
 2023-05-25 13:02:22 +02:00
nikstur 19f59af2d8
contributing: fix link (#568) 2023-05-19 09:41:51 +02:00
Valentin Gagarin dd3deb5008
Update source/recipes/faq.md 2023-05-16 01:33:10 +02:00
Valentin Gagarin 3c857b4589
improve wording in contribution guide (#549) 
* improve wording in contribution guide
 2023-05-16 00:41:00 +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 7f3c6e1596
Merge pull request #551 from fricklerhandwerk/keywords 2023-05-14 10:39:27 +02:00
Domen Kožar 9f13d653fb
Merge pull request #262 from fricklerhandwerk/cla 
assign copyright to NixOS Foundation
 2023-05-12 13:04:00 +01: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 034b6485c6 update keywords and language 
most importantly Nixpkgs was missing.

the documentation team decided to use European English some time ago.
 2023-05-12 07:25:46 +02:00
Valentin Gagarin e47b082d22 turn anti-patterns into best practices 
make generous use of admonitions
 2023-05-12 05:49:48 +02:00
Valentin Gagarin c6cbc22211 FAQ: should I enable flakes 2023-05-12 04:07:58 +02:00
Valentin Gagarin 744eeafbda assign copyright to NixOS Foundation 
based on Nix documentation team discussion on 2022-07-07
https://discourse.nixos.org/t/2022-07-07-documentation-team-meeting-notes-4/20198

"the author" are now nix.dev contributors, as this is the most accurate
way we can currently represent it. eventually we should provide a way to
credit authorship more precisely.
 2023-05-11 20:48:39 +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
Zach Mitchell b573def109 Set the structure of the tutorials section 2023-05-07 09:08:04 -06:00