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
Domen Kožar
ba29afd841
Merge pull request #370 from yukiisbored/possesive-its
...
Possesive its
2022-10-22 19:21:26 +02:00
Neyts Zupan
a6cb86c1cd
Merge pull request #361 from yukiisbored/add-filtered-issues-list
...
Add filtered issues list
2022-10-22 16:41:01 +01:00
Yuki Langley
3effde4b66
Use possesive not contraction
2022-10-22 17:35:41 +02:00
Yuki Langley
34455a9d5b
Add filtered list of issues for each concern
2022-10-22 17:34:06 +02:00
Luc Perkins
9e5388163f
Merge pull request #369 from NixOS/cleanup/rst_to_md
...
Fix leftovers from .rst -> .md migration
2022-10-22 17:23:52 +02:00
Nejc Zupan
5ab8d5a77f
Fix leftovers from .rst -> .md migration
...
Sphinx doesn't care about filetype suffixes so we didn't see any errors.
But it's still nice to do this bit of gardening, I suppose?
2022-10-22 17:21:04 +02:00
Neyts Zupan
5015cb147d
Merge pull request #353 from yukiisbored/move-contributing-to-top-level
...
Move contributing from tutorials to top-level
2022-10-22 16:13:35 +01:00
Domen Kožar
3c5fba5e04
Merge pull request #363 from fricklerhandwerk/how-to-contribute-to-documentation
...
add links to docs contributing guide
2022-10-22 16:46:55 +02:00
Nejc Zupan
7208071066
Add support for CloudFlare Pages's redirects
...
And add a redirect for moving contributing.md to root.
2022-10-22 16:45:35 +02:00
Emilia Bopp
9866e98e1c
Remove the remainder of collaboration.md
...
Everything else is already covered in the documentation contribution guide.
2022-10-22 16:34:12 +02:00
Valentin Gagarin
27008b3f50
add links to docs contributing guide
2022-10-22 16:31:48 +02:00
Emilia Bopp
96e8f4f633
Move agenda changes into README
2022-10-22 16:29:28 +02:00
Emilia Bopp
d30489743a
Reduce collaboration to clearly defined points
...
The remainder will be opened as GitHub issues.
2022-10-22 16:29:28 +02:00
Emilia Bopp
4479391302
Describe collaboration among maintainers
2022-10-22 16:29:28 +02:00
Domen Kožar
63b5ac369f
Merge pull request #349 from lucperkins/lperkins/codeowners
...
Add CODEOWNERS system to nix.dev
2022-10-22 16:23:26 +02:00
github-actions[bot]
9e21d48418
@minijackson has signed the CLA from Pull Request #362
2022-10-22 14:16:45 +00:00