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

962 commits

Author SHA1 Message Date
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
Valentin Gagarin 66f4ec50ff
Merge pull request #383 from fricklerhandwerk/documentation-team-handbook
fix inconsistent reference links
2022-11-04 12:26:30 +01:00
Valentin Gagarin 6991d4ca3b fix inconsistent reference links 2022-11-04 12:25:49 +01:00
Valentin Gagarin 2d989f4bda
Merge pull request #372 from yukiisbored/linkcheck-gh-fail
Rewrite GitHub anchor links to `user-content-`
2022-11-03 19:14:47 +01:00
Valentin Gagarin 709d0a1a69
Merge pull request #382 from fricklerhandwerk/documentation-team-handbook
update documentation team information
2022-11-03 19:08:12 +01:00
Valentin Gagarin 8377654ef1 update documentation team information
@lucperkins now serves as team lead

fix formatting, typos, and use past tense for things of the past.
2022-11-03 18:52:42 +01:00
Valentin Gagarin 82ad7c266c
Merge pull request #354 from milibopp/maintainer-collaboration
Describe maintainer collaboration
2022-11-03 18:22:38 +01:00
Valentin Gagarin cd2125c538
PR -> pull request 2022-11-03 18:19:25 +01:00
Yuki Langley 7ba7bb2744 Mention linkcheck bug with GitHub heading anchors 2022-11-03 17:37:10 +01:00
Yuki Langley a4a6ce812b Rewrite GitHub anchor links to user-content-
Due to an Sphinx issue[1], linkcheck fails on GitHub anchors for
GitHub rendered documents.

This change rewrites the anchors to the ones that can be verified by
linkcheck.

[1]: https://github.com/sphinx-doc/sphinx/issues/9016
2022-11-03 17:36:40 +01:00
Valentin Gagarin 20bf073984
Merge pull request #380 from yukiisbored/unified-glossary 2022-10-29 08:55:13 +02:00
Yuki Langley 9b01513c45 Fold terminology section to glossary document
Resolves https://github.com/NixOS/nix.dev/issues/377
2022-10-28 19:47:15 +02:00
Domen Kožar af0d9dac02
Merge pull request #379 from NixOS/dependabot/github_actions/cachix/cachix-action-12
chore(deps): bump cachix/cachix-action from 11 to 12
2022-10-28 11:54:08 +02:00
dependabot[bot] 53c48d361d
chore(deps): bump cachix/cachix-action from 11 to 12
Bumps [cachix/cachix-action](https://github.com/cachix/cachix-action) from 11 to 12.
- [Release notes](https://github.com/cachix/cachix-action/releases)
- [Commits](https://github.com/cachix/cachix-action/compare/v11...v12)

---
updated-dependencies:
- dependency-name: cachix/cachix-action
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
2022-10-28 00:48:10 +00:00
Valentin Gagarin 6b6dac8a6b
Merge pull request #343 from jherland/nix-language-readthrough
Nix language tutorial: fix typos, add notes
2022-10-27 10:06:15 +02:00
github-actions[bot] eb51114dbd
@ners has signed the CLA from Pull Request #374 2022-10-26 16:08:42 +00:00
Domen Kožar 130df21a71
Merge pull request #373 from nh2/patch-1
integration testing: Fix attribute name for interactive testing
2022-10-25 13:28:32 +01:00
Niklas Hambüchen 5d4cadace9
integration testing: Fix attribute name for interactive testing
According to

70ec3b9f54/nixos/doc/manual/development/running-nixos-tests-interactively.section.md (running-tests-interactively-sec-running-nixos-tests-interactively)

`driverInteractive` is needed, and just `driver` indeed just runs through
without giving me an interactive shell.
2022-10-25 13:54:53 +02:00