!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

382 Members
This is the official channel for documentation in the Nix ecosystem. The documentation team meets here. More information: https://nixos.org/community/teams/documentation Video conference: https://jitsi.lassul.us/nix-documentation Meeting notes scratch pad: https://pad.lassul.us/p-Y8MjU2SdSD5qO1fnpCPA Past meeting notes: https://discourse.nixos.org/search?q=documentation%20team%20meeting%20order%3Alatest 70 Servers

Load older messages


SenderMessageTime
25 Jan 2024
@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
@jade_:matrix.org@jade_: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
including in reference docs. there are no callPackage reference docs (!)
00:12:03
@jade_:matrix.org@jade_:matrix.org 9999years wrote some docs for it but they were in a pr that was rejected for containing guide level docs 00:12:52
@jade_:matrix.org@jade_:matrix.org(in nixpkgs)00:13:01
@9999years:matrix.org@9999years:matrix.orgtheoretically i could've moved them over to nix.dev but i don't think the signposting is good enough for anyone to find them yet00:13:49
@9999years:matrix.org@9999years:matrix.orgi also want to get this resolved before adding more 'guide' material https://github.com/NixOS/nix.dev/issues/84500:21:33
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @jade_:matrix.org
9999years wrote some docs for it but they were in a pr that was rejected for containing guide level docs
I actually started messing around with that and got stuck in a rabbit hole to refactor callPackage...
02:09:23
@infinisil:matrix.orginfinisil
In reply to @jade_:matrix.org
9999years wrote some docs for it but they were in a pr that was rejected for containing guide level docs
This is the PR: https://github.com/NixOS/nixpkgs/pull/270696
I think it's dishonest to call that rejected. I just said that part of that PR should go to nix.dev instead. I even mentioned that the content is looking good.
03:45:53
@infinisil:matrix.orginfinisilBtw I'm fairly lenient with documentation (at least recently). I don't really care about how stuff is written down exactly. I just check some basic stuff like if it's in the right place, if it's correct, etc. As long as that's the case, I'm willing to merge doc changes03:52:45
@infinisil:matrix.orginfinisilThis is in contrast to actual interface changes in the code, which are full of intricacies that we can't easily revert once committed. So I take much more care in reviewing such PRs :)03:54:31
@charles:computer.surgeryCharleshttps://github.com/NixOS/nixpkgs/pull/264621#issuecomment-1910806642 this kind of thing should probably go in the nixos manual shouldn't it? (i thought i'd ask here first since i don't want to comment on this PR just to be wrong lol)04:34:02
@jade_:matrix.org@jade_:matrix.orgI think that was a misread/miscommunication then, sorry about that.05:05:50
@dooy:matrix.org@dooy:matrix.org changed their display name from Dooygoy to stablejoy.13:37:38
@lehmanator:gnulinux.club@lehmanator:gnulinux.club removed their profile picture.16:53:50
@lehmanator:gnulinux.club@lehmanator:gnulinux.club removed their display name Sam Lehman.17:02:02
@lehmanator:gnulinux.club@lehmanator:gnulinux.club left the room.17:05:08
28 Jan 2024
@infinisil:matrix.orginfinisil
In reply to @jade_:matrix.org
I think that was a misread/miscommunication then, sorry about that.
All good ❤️
03:01:42

Show newer messages


Back to Room ListRoom Version: 6