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

958 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