!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

422 Members
Discussion about documentation improvements around the Nix ecosystem86 Servers

Load older messages


SenderMessageTime
22 Jan 2024
@fractivore:cyberia.club@fractivore:cyberia.club joined the room.23:11:44
@fractivore:cyberia.club@fractivore:cyberia.clubWould this be the right place to provide feedback on nix-pills? It's the closest I've found so far. My complaint is that Chapter 2 could use a lot of improvement. It's missing a lot of context needed to make it understandable to the target audience, and this is a problem considering it's the first true "meaty" chapter (chapter 1 being a justification of why you should use Nix at all).23:17:16
@fractivore:cyberia.club@fractivore:cyberia.clubI 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.orgefx changed their display name from efx to Eli Flanagan.17:59:28
@efx:matrix.orgefx changed their display name from Eli Flanagan to efx.18:00:40
@waldyrious:matrix.orgwaldyrious left the room.22:17:54
25 Jan 2024
@efx:matrix.orgefx changed their profile picture.00:12:31
@efx:matrix.orgefx 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
27 Jan 2024
@janejasperous:nadanix.comJane Jasperous joined the room.00:07:52

Show newer messages


Back to Room ListRoom Version: 6