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

30 commits

Author SHA1 Message Date
Valentin Gagarin a792a25bb0
update contributing instructions (#987)
* update contributing instructions

running devmode with `--run` doesn't actually work, it doesn't pick up
the changes
2024-05-26 17:09:24 +02:00
Valentin Gagarin 7fddd6c9bd deduplicate CONTRIBUTING.md
all the information is alreaady in the contributing guide on the website
2024-04-09 17:24:47 +02:00
Valentin Gagarin e837576351 refactor
this change also places all historical Nix manuals under a stable URL
2024-04-03 13:59:14 +02:00
Valentin Gagarin 3ffb8d8227 rework the way redirects are built 2024-04-03 09:21:26 +02:00
Valentin Gagarin dfe8b1a2e6 remove original from CONTRIBUTING.md 2024-02-27 03:02:40 +01:00
Valentin Gagarin 4f9862fdb9
disable linkcheck for GitHub anchor links (#859)
apparently it got (a lot) worse and GitHub doesn't render README files
statically any more.

this obviates the need of additional instructions.
2024-01-15 10:16:39 +00:00
fricklerhandwerk fee5c5c2ab add update instructions 2023-11-27 07:30:36 +01:00
fricklerhandwerk 8346ccdc7f remove the vision outline
we're already close enough to the original idea that there is no need to
keep it here.
2023-11-02 20:39:29 +01:00
Lorenzo Manacorda 1dcc111a4d *: fix editorconfig errors 2023-10-06 10:59:27 +02:00
Henrik 8954c4d7c1
What you can do for the documentation survey (#647)
Add instructions for contributing to the documentation survey.

---------

Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>
2023-07-16 10:48:55 +02:00
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