Valentin Gagarin
2ae6b07a97
move more writing style recommendations into the public guide ( #607 )
2023-06-22 11:18:22 +02:00
Valentin Gagarin
41a8e0aefa
add NixOS testing to vision diagram ( #557 )
2023-05-17 09:34:53 +01:00
Valentin Gagarin
314eb28baf
add outline to contributing guide ( #265 )
2023-03-16 18:04:05 +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
Yuki Langley
7ba7bb2744
Mention linkcheck bug with GitHub heading anchors
2022-11-03 17:37:10 +01: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
Valentin Gagarin
6202509d27
the Nix language
2022-10-05 00:57:26 +02:00
Valentin Gagarin
c0ccc78d3a
reduce to minimal proposal
...
based on https://github.com/NixOS/nix.dev/issues/275#issuecomment-1227572104
@edolstra proposed using "Nixpkgs" as a proper name
- this is not pronouncible from just reading it, but at least it's brief
and unambiguous
-> added pronounciation
@uningan pointed out Nix is more than just a package manager, but also
a built system.
- this is true, and probably we don't have to reflect that in the proper
name
- also don't have to change anything if we keep Nix
-> back to just Nix
multiple threads of discussion diverged into very broad proposals to
rename things, but the focus here should be on the smallest possible change to
improve clarity and get consensus on something at all.
-> removed additional proposals, which are tangential
2022-09-14 12:31:20 +02:00
Valentin Gagarin
e80a6ac8b4
Update CONTRIBUTING.md
...
Co-authored-by: Benoit de Chezelles <bew@users.noreply.github.com>
2022-09-14 12:31:20 +02:00
Valentin Gagarin
2d1ad2120f
add NixOS module collection
2022-09-14 12:31:20 +02:00
Valentin Gagarin
d979e46a44
add terminology to cli
2022-09-14 12:31:20 +02:00
Valentin Gagarin
0a671e0646
explain notation
2022-09-14 12:31:20 +02:00
Valentin Gagarin
99daf5489c
add IPA pronounciation to NixOS
2022-09-14 12:31:20 +02:00
Valentin Gagarin
ac91e7e662
nomenclature -> terminology
...
it's a more common term and hopefully easier to pronounce
2022-09-14 12:31:18 +02:00
Valentin Gagarin
175d1f6076
codify nomenclature
2022-09-14 12:26:14 +02:00
Valentin Gagarin
dde060e390
add note on breaking lines on sentence boundaries
2022-09-08 19:18:51 +02:00
Valentin Gagarin
c24a1b626e
add contribution guide
...
based on Nix documentation team discussion on 2022-07-07
https://discourse.nixos.org/t/2022-07-07-documentation-team-meeting-notes-4/20198
2022-09-08 19:18:15 +02:00
Valentin Gagarin
ac8b2b2eb8
contributing: add plain language guidelines
...
not surprizingly, they have a point.
2022-09-06 22:42:30 +02:00
Valentin Gagarin
a57f354e37
style guide: use culturally neutral language
2022-07-29 01:21:59 +02:00
Valentin Gagarin
23d80a0bea
suggest which voice to use
2022-07-11 14:48:50 +01:00