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

892 commits

Author SHA1 Message Date
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
Valentin Gagarin 9c40053672
Merge pull request #351 from fricklerhandwerk/how-to-contribute-to-documentation
add guide to contribute to documentation in the ecosystem
2022-10-22 16:14:05 +02:00
Valentin Gagarin 6f4283c6e1 update link to documentation team info 2022-10-22 16:13:02 +02:00
Valentin Gagarin 1c2a046196
Merge pull request #346 from NixOS/documentation-team-handbook
add section for documentation team
2022-10-22 16:10:36 +02:00
Valentin Gagarin 332d129f29 update team information 2022-10-22 15:24:02 +02:00