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

649 commits

Author SHA1 Message Date
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
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
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
Jonathan Arnett 9c7e4a8156
Use bold instead of monospace for emphasis 2023-09-02 23:17:53 -04: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
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
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
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 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 a0a4cd8968 Update with review comments 2023-08-09 22:06:21 -06: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
Jeremy fd9c34b940
Clarify and fix grammar/spelling mistakes in the installation guide for the Pi (#667) 2023-08-01 20:49:32 +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
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
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
John Bowdre 21abf7b6ad
Fix typo in ad-hoc-shell-environments.md (#652)
Footnote 2: 'packges' -> 'packages'
2023-07-19 16:25:07 +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
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 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 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
Yuki Langley 9aaa97a8b0
Make home page cards clickable (#616) 2023-06-25 14:13:20 +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
Raphael Das Gupta 41ab7e1ee0
write "GitHub" with a uppercase "H" (#574) 2023-05-29 07:31:14 +01: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