NixOS/nix.dev
NixOS/nix.dev
1
0
Fork 0
mirror of https://github.com/NixOS/nix.dev.git synced 2024-10-18 00:06:26 -04:00
Code Activity
Official documentation for getting things done with Nix.
1609 commits 15 branches 0 tags 6.2 MiB
Nix 33.1%
Python 33%
Makefile 16.1%
Shell 12.2%
CSS 4.9%
Other 0.7%
Find a file
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
.github Merge pull request #842 from fricklerhandwerk/unsubscribe 2024-01-15 21:05:48 +01:00
maintainers update information flow diagram 2024-01-31 23:19:34 +01:00
nix use upstream page redirects for Nix manual (#829) 2024-01-15 13:44:42 +01:00
source front page: Who is Nix for? (#872) 2024-02-02 01:29:40 +01:00
vale File sets tutorial (#802) 2023-11-23 17:14:46 +01:00
.editorconfig editorconfig: init 2023-10-06 10:50:04 +02:00
.envrc unignore .envrc 2023-11-13 13:28:42 +01:00
.gitignore unignore .envrc 2023-11-13 13:28:42 +01:00
.imgbotconfig housekeeping: enable devenv, automatic updates, CLA+license 2020-06-12 17:30:22 +00:00
.vale.ini Enable custom vocabulary 2023-11-13 13:45:49 +01:00
_redirects use upstream page redirects for Nix manual (#829) 2024-01-15 13:44:42 +01:00
CONTRIBUTING.md disable linkcheck for GitHub anchor links (#859) 2024-01-15 10:16:39 +00:00
default.nix use upstream page redirects for Nix manual (#829) 2024-01-15 13:44:42 +01:00
LICENSE.md LICENSE: CC BY-NC -> CC BY-SA for better compatibility 2020-06-16 15:38:01 +02:00
Makefile add SOURCE_DATE_EPOCH to Makefile to fix copyright year (#800) 2023-11-15 05:16:27 +01:00
overlay.nix add python dependency sphinx-sitemap 2023-10-10 19:52:26 +01:00
README.md move devmode helper into flake 2023-10-18 15:33:06 +02:00
run_code_block_tests.sh Proof-of-Concept for testing code samples 2022-04-07 10:16:17 +01:00
runtime.txt pin python for cloudflare 2022-06-27 10:26:49 -05:00
shell.nix remove flake.nix 2023-11-07 03:04:28 +01:00

README.md

CI

nix.dev

Official documentation for getting things done with Nix.

Contributing

Run nix-shell --run devmode and open a browser at http://localhost:5500.

As you make changes your browser should auto-reload within a few seconds.

For contents and style see contribution guide.

Content is written in MyST, a superset of CommonMark. For its syntax, see the MyST docs.