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

11 commits

Author SHA1 Message Date
Valentin Gagarin 3b5fee627c update contributing guides
- clarify a few phrases
- move Open Collective link to the top
- add section headings for easier navigation
- add a few details on contacting people
2024-02-05 13:42:29 +01:00
Valentin Gagarin 22bedeaba0
front page: Who is Nix for? (#872)
* front page: Who is Nix for?

For at least two years there were ongoing debates about the target
audience of the Nix ecosystem. Nix maintainers did not manage to
converge on a statement [0]. The marketing team is explicitly focusing
on software developers [1], and the documentation team was supposed to
align with that from the very beginning [2].

What was missing so far was what we mean by "software developers".
Arguably, it encompasses a particular mind set about how to deal with
computers and enough time to learn things.

And while for documentation it matters most *what* the software is doing
rather than *who* it is made for (or by), the ecosystem is a community
effort, and people matter [3]. So far, we haven't really identified the
(eventual) boundaries of this community (at least I don't know of any
serious attempt), which also plays into the definition of a target
audience. Yet, in practice, not every contribution, not every question
or comment is treated equally, and this has reasons in our implicit
assumptions about who belongs.

This is an attempt to draw such a boundary that is not arbitrary, and
neither to narrow nor too wide. The goal is, as always, to help
Nix beginners set realistic expectations for their journey.

The list of occupations/interests who may benefit from Nix is based on
the 2022 [4] and 2023 [5] community surveys.

[0]: https://github.com/NixOS/nix/pull/7156
[1]: 76d42a052d/community/teams/marketing.tt (L89)
[2]: https://discourse.nixos.org/t/2022-06-15-documentation-team-meeting-notes-1/20004
[3]: https://discourse.nixos.org/t/zurich-23-05-zhf-hackathon-and-workshop-report/29093#ux-workshop-21
[4]: https://discourse.nixos.org/t/2022-nix-survey-results/18983
[5]: https://discourse.nixos.org/t/nix-community-survey-2023-results/33124

Co-authored-by: Daniel Sidhion <DanielSidhion@users.noreply.github.com>
2024-02-02 01:29:40 +01:00
fricklerhandwerk ef8c0b72ab refer to contributing guides in the respective projects
this is where the information will be most up-to-date and where it
should be maintained to begin with.
2023-10-19 12:17:00 +02:00
Valentin Gagarin 50007ff30b nest documentation stuff one level deeper 2023-09-07 12:06:29 +02:00
Valentin Gagarin 783913c8cd
highlight call for donations (#703) 2023-08-29 21:07:48 +02:00
Valentin Gagarin def3fbd071 add pointers for making donations 2023-07-21 09:32:41 +02:00
Valentin Gagarin 875cb4ae06 expand contribution guidelines
in particular, give more concrete tips on filing issues.
this is based on experience with helping to maintain Nix and trying to make
sense of what's going on in Nixpkgs.
2023-07-21 09:32:41 +02:00
Valentin Gagarin ea9def69c7 fix typos 2023-07-20 15:14:35 +02:00
nikstur 19f59af2d8
contributing: fix link (#568) 2023-05-19 09:41:51 +02:00
Valentin Gagarin 3c857b4589
improve wording in contribution guide (#549)
* improve wording in contribution guide
2023-05-16 00:41:00 +02:00
Zach Mitchell 20f2673d70 Add recipes, reference, and contributing sections 2023-04-13 21:50:10 -04:00
Renamed from source/contributing/index.md (Browse further)