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

908 commits

Author SHA1 Message Date
fricklerhandwerk cd1abe532b use self-descriptive link text, imperative for instructions 2023-10-07 04:12:44 +02:00
fricklerhandwerk a1b582f33a modules are not a convention 2023-10-07 04:12:44 +02:00
fricklerhandwerk 82e7185436 remove superfluos capitalisation 2023-10-07 04:12:44 +02:00
fricklerhandwerk 4bcf52fe1b reword learning goal to use more keywords 2023-10-07 04:12:43 +02:00
fricklerhandwerk d59250908d remove compatibility blurb
readers don't even need to think about it, as it's encoded in the pinned
source. at best this would be a note to maintainers, but we should know
that as well.
2023-10-07 04:11:46 +02:00
fricklerhandwerk 776d19f8e8 dedent list 2023-10-07 04:11:44 +02:00
fricklerhandwerk d876a318bc more concise instructions 2023-10-07 00:37:42 +02:00
fricklerhandwerk 4b814d5d37 more precise heading 2023-10-07 00:37:27 +02:00
fricklerhandwerk e6ae1afaed highlight password security warning in NixOS example 2023-10-06 23:23:50 +02:00
Valentin Gagarin a279bfbd6a
avoid gerund 2023-10-06 23:21:20 +02:00
Valentin Gagarin 35ae4de7ca
more mundane grammar 2023-10-06 23:20:19 +02:00
fricklerhandwerk 07ea1eb6b2 rework the multi-machine example
- use the same Nixpkgs release to avoid massive downloads
- continue using `pkgs.nixosTest`; the new thing is completely undocumented
- use a shorthand module; `lib` is not used
- use an empty nginx config; commented-out code is confusing
- move explanation of the test script to the end; use imperative
- add instructions to run it
2023-10-06 22:51:08 +02:00
fricklerhandwerk e5f8ca0a9d reword introduction to multi-machine example 2023-10-06 22:51:07 +02:00
fricklerhandwerk 2a8bc7dd63 more concise heading 2023-10-06 22:50:46 +02:00
fricklerhandwerk 256bcd47ea remove superfluos empty line 2023-10-06 22:50:46 +02:00
fricklerhandwerk f15b5a4df3 build up example as numbered list
while section headings are good for linking, this is not very important
here. the heading distract from the sequential structure, which the list
exposes more clearly.
2023-10-06 22:50:46 +02:00
fricklerhandwerk 5fd6576a8d fix wording 2023-10-06 22:50:46 +02:00
fricklerhandwerk 0e63b762b9 clarify wording around module options 2023-10-06 22:50:46 +02:00
fricklerhandwerk 0067b57ebc remove superfluos indentation 2023-10-06 22:50:46 +02:00
fricklerhandwerk 14adbcfb87 use self-descriptive link text 2023-10-06 22:50:46 +02:00
fricklerhandwerk c7dfcb7968 link to main Nix installation instructions 2023-10-06 22:50:46 +02:00
fricklerhandwerk 1ad3a3e2f8 more specific title 2023-10-06 22:50:46 +02:00
olaf 13ca4846b2 fix wording 2023-10-06 22:50:46 +02:00
olaf 56426054ed unrelated fixes 2023-10-06 22:50:46 +02:00
olaf 4509761055 simple server client test 2023-10-06 22:50:45 +02:00
Valentin Gagarin 8ef096641d
Merge pull request #741 from fricklerhandwerk/move-installation
move installation instructions to top level
2023-10-06 13:36:34 +02:00
Valentin Gagarin a8723671ee
Merge pull request #745 from NixOS/editorconfig
Add EditorConfig file and fix errors
2023-10-06 12:09:23 +02:00
Valentin Gagarin d7556d18b1
Merge pull request #728 from g-re-g/patch-1
change "build task" to "derivation" in tutorial

"build task" invokes associations with pre-existing knowledge. As long as they are clearly explained, it is easier for beginners to pick up a new word than it is to add a new definition to an existing word that subtly differs from the other definitions it has. To that extent, "derivation" is probably a great word for Nix as, at least in this domain, it is very Nix specific and so, with clear definition, it should be easy to convey the idea to other folks that we are talking about something Nix specific.
2023-10-06 12:02:22 +02:00
Lorenzo Manacorda 1dcc111a4d *: fix editorconfig errors 2023-10-06 10:59:27 +02:00
fricklerhandwerk 8c74278eff update front-page instructions 2023-10-06 09:46:54 +02:00
fricklerhandwerk c0ef0b5988 move installation instructions to top level
it's not a tutorial and should be immediately accessible
2023-10-06 09:46:54 +02:00
Silvan Mosberger 43bede33bc
Merge pull request #743 from fricklerhandwerk/move-name-origin
move conceptual question to FAQ section
2023-10-06 03:10:11 +02:00
fricklerhandwerk 8f2514019f add history bit on the logo 2023-10-05 17:59:49 +02:00
fricklerhandwerk 6b2e4aecf3 move conceptual question to FAQ section 2023-10-05 17:59:47 +02:00
fricklerhandwerk 5eafb74584 use pluralised link text 2023-10-05 17:37:30 +02:00
fricklerhandwerk 75b4d54553 use less repetitive wording 2023-10-05 17:37:21 +02:00
fricklerhandwerk 83f400e4d6 fix broken reference links 2023-10-05 17:36:56 +02:00
Valentin Gagarin 742d9b38ed
fix typo 2023-10-05 17:20:14 +02:00
fricklerhandwerk 47d03a8e3b move questions about flakes into FAQ
keep the concept description separate and easy to find at the top level
2023-10-05 16:58:45 +02:00
wamirez 73056b06da put faqs to the bottom of the sidebar 2023-10-04 17:20:12 -04:00
wamirez 0198889157 fix a few typos and add links to some concepts 2023-10-04 16:53:50 -04:00
wamirez b4a2472d96 move 'Should I enable Flakes?' -f recipes -t concepts 2023-10-04 16:16:53 -04:00
a c sreedhar reddy f2fe0aa56b
Remove write space in shebang line (#736) 2023-10-03 10:12:05 +02:00
Rosario Pulella be7c3bec3d
faq: Add nixos-anywhere to bootsrapping NixOS (#734) 2023-10-02 08:55:31 +02:00
Yann Hamdaoui 62db5ba51d
Remove superfluous variation of a snippet (#732)
The cross compilation documentation is showing, at some point, two
variations on how to get a cross-compiled package out of Nixpkgs. Those
two versions are strictly equivalent (the only difference is what part
of the full attribute set paths is put in the variable named `pkgs`) and
don't really improve understanding - arguably, rather hurts it.
2023-09-20 21:51:32 +02:00
g-re-g f381e24357
Better terminology for string interpolation of derivations
Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>
2023-09-14 13:00:00 -04:00
g-re-g 11f943e3b3
Remove description of derivation using "build task"
Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>
2023-09-14 12:59:25 -04:00
Valentin Gagarin 68839d3d60
Merge pull request #621 from CyberShadow/patch-1
tutorials/first-steps/nix-language: Fix the nixpkgs example
2023-09-14 15:24:30 +02:00
g-re-g f60d8a8671
change "build task" to "derivation" in tutorial 2023-09-13 14:15:26 -04:00
Guillaume Desforges ff9af7402b homepage: put link to first steps at the top. 2023-09-12 15:36:50 +02:00
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