!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

420 Members
Discussion about documentation improvements around the Nix ecosystem87 Servers

Load older messages


SenderMessageTime
20 Jan 2024
@r_i_s:matrix.orgris_just a sec12:37:31
@r_i_s:matrix.orgris_ok fixed12:42:52
@infinisil:matrix.orginfinisil ris_: Merged! 21:39:44
22 Jan 2024
@johannes.kirschbauer:scs.ems.host@johannes.kirschbauer:scs.ems.host danielsidhion: philipp I pm ed you, lets schedule our meet! Once we find a suitable schedule we'd announce it if anyone else wants to join. 11:41:25
@ThorHop:matrix.org@ThorHop:matrix.org changed their display name from hopland to IdeallyYes.15:06:13
@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

Show newer messages


Back to Room ListRoom Version: 6