!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

431 Members
Discussion about documentation improvements around the Nix ecosystem89 Servers

You have reached the beginning of time (for this room).


SenderMessageTime
22 Jan 2024
@fractivore:cyberia.clubSYMYƧI also don't entirely understand the history and context of the guide itself. I find it's being suggested as the de-facto standard for learning how to write derivations. Yet, it reads as though it was the work of a single author. Is nix-pills an "official" document that is community maintained? That's kind of how I've been treating it in suggesting improvements, because I've seen it presented as this de-facto standard.23:21:37
23 Jan 2024
@infinisil:matrix.orginfinisil symys: The nix pills live in the official GitHub organisation, so they're official: https://github.com/NixOS/nix-pills 01:06:33
@infinisil:matrix.orginfinisilI personally don't think they're as useful as they're made out to be, and would favor deprecating them01:07:33
@infinisil:matrix.orginfinisilThe documentation team is focusing on https://nix.dev/ as the way forward (also official)01:07:57
@infinisil:matrix.orginfinisilDespite that, the nix pills are still somewhat maintained, so if you make a PR, the docs team could review and merge that :)01:09:29
@efx:matrix.orgEli Flanagan changed their display name from efx to Eli Flanagan.17:59:28
@efx:matrix.orgEli Flanagan changed their display name from Eli Flanagan to efx.18:00:40
@waldyrious:matrix.org@waldyrious:matrix.org left the room.22:17:54
25 Jan 2024
@efx:matrix.orgEli Flanagan changed their profile picture.00:12:31
@efx:matrix.orgEli Flanagan changed their display name from efx to Eli Flanagan.00:12:39
@infinisil:matrix.orginfinisil I recently mentioned the thought of moving nix.dev to docs.nixos.org instead. While we can argue whether nix.dev or nixos.org should be the canonical domain, for now it's nixos.org, with only nix.dev out of line. So to achieve a single canonical domain, moving nix.dev to docs.nixos.org is much easier compared to moving nixos.org to nix.dev. 17:40:59
@infinisil:matrix.orginfinisilHere's my comment on this: https://github.com/NixOS/foundation/issues/113#issuecomment-190672270717:41:06
@infinisil:matrix.orginfinisilAnd an RFC draft: https://github.com/nix-rfc-canonical-domain/rfcs17:41:18
@infinisil:matrix.orginfinisil Since nix.dev only really concerns the docs team, we can easily move it to docs.nix.dev without going through an RFC by just reaching consensus among the team 17:42:26
@infinisil:matrix.orginfinisilI'll create an issue on the nix.dev repo for this17:43:25
@infinisil:matrix.orginfinisil danielsidhion: Unrelated to the above, relevant issue for you: https://github.com/NixOS/nix.dev/issues/423 17:45:41
@infinisil:matrix.orginfinisil
In reply to @infinisil:matrix.org
I'll create an issue on the nix.dev repo for this
https://github.com/NixOS/nix.dev/issues/869
18:13:54
26 Jan 2024
@qyriad:matrix.org@qyriad:matrix.org
In reply to @infinisil:matrix.org
I personally don't think they're as useful as they're made out to be, and would favor deprecating them
They're missing a lot but also they're the only real place that explains callPackage which is essential to understanding Nixpkgs
09:36:32
@soispha:vhack.euBenedikt joined the room.11:02:22
@asymmetric:matrix.dapp.org.ukasymmetric
In reply to @infinisil:matrix.org
Since nix.dev only really concerns the docs team, we can easily move it to docs.nix.dev without going through an RFC by just reaching consensus among the team
i think you mean docs.nixors.org here?
11:57:38
@asymmetric:matrix.dapp.org.ukasymmetric
In reply to @infinisil:matrix.org
Since nix.dev only really concerns the docs team, we can easily move it to docs.nix.dev without going through an RFC by just reaching consensus among the team
* i think you mean docs.nixos.org here?
11:57:54
@infinisil:matrix.orginfinisil Ahh whoops, yes! 11:58:09
@infinisil:matrix.orginfinisil * Since nix.dev only really concerns the docs team, we can easily move it to <del>docs.nix.dev</del> docs.nixos.org without going through an RFC by just reaching consensus among the team 11:59:22
@9999years:matrix.org@9999years:matrix.org
In reply to @qyriad:matrix.org
They're missing a lot but also they're the only real place that explains callPackage which is essential to understanding Nixpkgs
i actually really like the nix pills. they're a gentle introduction to nix that does a good job at motivating why it's useful & bundles together writing nix expressions with nixpkgs architecture concepts
17:53:00
@qyriad:matrix.org@qyriad:matrix.orgYes very much agreed on that17:53:16
@9999years:matrix.org@9999years:matrix.orghaving helped a few people get started with nix recently, none of them have found the nix pills on their own though17:53:33
@9999years:matrix.org@9999years:matrix.orgi would support rewriting the nix pills and moving them into a tutorial or getting started guide on nix.dev though17:53:51

Show newer messages


Back to Room ListRoom Version: 6