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

929 commits

Author SHA1 Message Date
Yuki Langley 505a96774c Use dropdown instead of details 2022-12-18 21:53:52 +01:00
Yuki Langley f92b748a76 Update poetry.lock 2022-12-18 21:29:51 +01:00
Yuki Langley 3937aef0c6 Add sphinx-design extension 2022-12-18 21:29:44 +01:00
Yuki Langley 7af51a0055 Revert "Make details visually consistent"
This reverts commit 86d03051cc.
2022-12-18 21:23:56 +01:00
Yuki Langley 4b1303ccae Make details summary more consistent 2022-12-18 21:18:28 +01:00
Yuki Langley f9553d0c76 Make opened details padding consistent 2022-12-18 21:18:28 +01:00
Yuki Langley a230e3d523 Handle admonition classes inside details 2022-12-18 21:18:28 +01:00
Yuki Langley 2c2f2c7427 Apply padding to all elements under details 2022-12-18 21:18:28 +01:00
Yuki Langley 79ca846ada Use Value instead of Result
Nix language tutorial asserts that it is called *Nix value* not *Nix
result*.
2022-12-18 21:18:28 +01:00
Yuki Langley 86d03051cc Make details visually consistent 2022-12-18 21:18:28 +01:00
Yuki Langley 742f525741 Distinguish visually between expression and result
Related to https://github.com/NixOS/nix.dev/pull/395
2022-12-18 21:18:28 +01:00
Yuki Langley 5f4c86bba0 Add hack to make CSS live-reload work 2022-12-18 21:18:28 +01:00
github-actions[bot] 6c3e74857a
@doubledup has signed the CLA from Pull Request #422 2022-12-17 14:35:26 +00:00
David Dunn 4965408021
Add fish shell syntax for process substitution 2022-12-17 13:11:48 +02:00
github-actions[bot] e161484f3f
@fricklerhandwerk has signed the CLA from Pull Request #421 2022-12-16 17:45:50 +00:00
Hans Christian v. Stockhausen e583297654
Fix minor error with import-builtin example (#421) 2022-12-16 18:45:35 +01:00
Yuki Langley f0239b6a91
Unify information on contributing documentation (#384)
* Unify information on contributing documentation to make it visible on nix.dev itself

Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>
2022-12-16 08:32:48 +01:00
github-actions[bot] 7a71718a64
@gkelly has signed the CLA from Pull Request #420 2022-12-14 16:29:09 +00:00
Garret Kelly 3264e91e74 Update example pinned nixpkgs to a recent one
The pinned nixpkgs in these examples does not work with more recent
versions of nix.

Fixes #419
2022-12-14 11:27:22 -05:00
Valentin Gagarin aeaf6a3cd9
Merge pull request #415 from mmolhoek/fix/document-pi-4-display-problem
Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>
2022-12-13 12:24:30 +01:00
Mischa Molhoek 8290fb7c8f Comment about display problems and fix with older kernel
Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>
2022-12-13 12:23:21 +01:00
Mischa Molhoek 26a7673f73
You have to run nixos-rebuild switch as well (#416) 2022-12-10 19:15:55 +01:00
github-actions[bot] fc17731639
@mmolhoek has signed the CLA from Pull Request #415 2022-12-10 09:30:51 +00:00
Yuki Langley 3f95a892ff
Rewrite "Set up development environment" (#376)
* Rewrite "Set up development environment"

The previous version is specific to Python as it uses
`buildPythonApplication` instead of `mkShell`.

This one is more general but maintains the same Python Flask web
application example.

* Update pinning-nixpkgs to use 22.11

Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>
2022-12-10 04:33:06 +01:00
Yuki Langley 8522325436
Add information on contributing documentation (#371)
* Add information on contributing documentation

* Refer to quick start on adding new packages

Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>
2022-12-10 04:24:06 +01:00
Yuki Langley 428416093c
Mention WSL 2 systemd support (#406) 2022-12-04 09:16:32 +01:00
Valentin Gagarin 6b22ce780c
complete the overview of maintainer responsibilities (#403)
as discussed by @NixOS/documentation-team

Co-authored-by: Minijackson <minijackson@riseup.net>
Co-authored-by: Silvan Mosberger <github@infinisil.com>
Co-authored-by: Luc Perkins <luc.perkins@determinate.systems>
2022-12-01 23:34:40 +01:00
Rémi NICOLE 6c1d2a122c
Maintainer responsibilities (#362)
maintainers: document responsibilities

as discussed by documentation team

Co-authored-by: Silvan Mosberger <github@infinisil.com>
Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>
2022-12-01 18:52:01 +01:00
Henrik fa6aebeea6
Correction in calling functions section (#402)
* correction in calling functions section

List elements separated by white space
examples were not generating correctly.
2022-11-26 01:24:13 +01:00
github-actions[bot] aa634fdbf1
@henrik-ch has signed the CLA from Pull Request #402 2022-11-25 21:58:37 +00:00
Jörg Thalheim 858bf0eae3
nix-language: attempt to simplify concept overview (#397)
In the current text its not even for me clear what it is referring to. This rewrite tries to give more examples for each concept of the language.

Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>
2022-11-24 10:05:32 +01:00
github-actions[bot] 1128941fdc
@Freed-Wu has signed the CLA from Pull Request #399 2022-11-22 12:22:12 +00:00
Valentin Gagarin 6ae488e715
Merge pull request #388 from fricklerhandwerk/nix-language-introduction
rework parentheses example
2022-11-18 17:16:39 +01:00
Valentin Gagarin ec14804aee
Merge pull request #387 from fricklerhandwerk/nix-language-examples
refine worked examples
2022-11-18 17:15:50 +01:00
Valentin Gagarin dd8e3f6aa3
Merge pull request #386 from fricklerhandwerk/nix-language-tutorial
Nix language tutorial: add explanation on how `pkgs.lib` is obtained
2022-11-18 17:15:15 +01:00
github-actions[bot] 84e71cdb84
@bee-san has signed the CLA from Pull Request #395 2022-11-17 12:54:16 +00:00
Valentin Gagarin 8efe974f67
Merge pull request #392 from fricklerhandwerk/nix-language-derivation 2022-11-12 12:09:49 +01:00
Valentin Gagarin 94ccec6111
Merge pull request #390 from yukiisbored/consistent-code-blocks 2022-11-12 10:47:28 +01:00
Valentin Gagarin a2f10f337f fix wording on derivations
most importantly, derivations are not a special data type, but only
a certain kind of attribute set with two magic attributes.

we don't go into the details of the magic here, because it's really hard
to explain concisely. it would only distract from the surface feature
we care about here: composition through store paths.
2022-11-11 10:40:33 +01:00
Valentin Gagarin 2bacb71b74
Merge pull request #391 from fricklerhandwerk/transcription-tasks 2022-11-10 21:58:50 +01:00
Valentin Gagarin 041e2dd9de
Update maintainers/how-to-contribute-to-documentation.md
Co-authored-by: Silvan Mosberger <github@infinisil.com>
2022-11-10 16:55:42 +01:00
Valentin Gagarin 3142ebdce3 formatting: fix indentation 2022-11-10 15:07:38 +01:00
Valentin Gagarin 57af388f1b add The Nix Hour recordings to list of transcription tasks 2022-11-10 15:05:20 +01:00
Valentin Gagarin ad19f50231 fix typos, grammar, indentation 2022-11-09 11:14:04 +01:00
Valentin Gagarin ecf756298f
Update source/tutorials/nix-language.md 2022-11-08 20:40:39 +01:00
Yuki Langley ac06c07360 Make code blocks consistent
Illustration of shell sessions or terminals should use shell-session.

Entire expressions should be encapsulated in code blocks, not inline code.
2022-11-08 17:37:41 +01:00
Valentin Gagarin ade558c532 rework parentheses example
it was reported that the list example was confusing and lacked
explanation.

moved the example to function application, and reduced the syntax notes
to "notes on whitespace". moved the emphasis on the goals of this
tutorial to its proper place in the introduction.

it's good to leave the whitespace notes in the introductory part,
because they are unspecific and clearly belong to the "don't worry, it
may look weird, but that doesn't matter" part.
2022-11-08 14:28:01 +01:00
Valentin Gagarin 9b63c68d5c refine worked examples
it was reported that the NixOS configuration is confusing, because
information is lacking to understand what it does.

added another note reminding of this tutorial's objective.

added section headings to give hints where to look next.
2022-11-08 13:35:51 +01:00
Valentin Gagarin 3b775207a5 clarify how library functions are implemented 2022-11-08 13:16:53 +01:00
Valentin Gagarin 4a18a5ffdc add explanation on how pkgs.lib is obtained 2022-11-08 12:38:20 +01:00