!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

404 Members
Discussion about documentation improvements around the Nix ecosystem78 Servers

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


SenderMessageTime
11 May 2025
@apeioo:matrix.orgLorenz joined the room.20:32:49
@apeioo:matrix.orgLorenzIs there any information when something goes in the NixOS manual, wiki or a Nix.dev guide? I don't really understand the difference between them.20:37:14
@sandro:supersandro.deSandro left the room.20:55:08
@fliegendewurst:matrix.orgFliegendeWurstHave you read https://nix.dev/contributing/documentation/resources already?21:21:14
13 May 2025
@adam:robins.wtf@adam:robins.wtf left the room.14:43:10
@apeioo:matrix.orgLorenzNo, I haven't, thanks for sharing. So the main difference is that the manual is edited by maintainers, wiki by the community and nix.dev by the documentation team? Why are things like Grocy in the NixOS manual and not the wiki? https://nixos.org/manual/nixos/stable/#module-services-grocy17:44:37
@fliegendewurst:matrix.orgFliegendeWurstThe module doc mentions some important stuff for using the module (database location, extending the builtin-in configuration)18:15:59
@fliegendewurst:matrix.orgFliegendeWurstSince that may change when the module definition is updated, it makes sense to keep it in nixpkgs18:16:50
@fricklerhandwerk:matrix.orgfricklerhandwerkIf you ask me (which you didn’t, but still :P), any information about modules should just live in the source and be published in the manual as the source changes. The problem is we’re lacking a bit of infrastructure and a lot of culture for that. And many contributors (rightfully) find it easier to edit the wiki with whatever is on their mind instead of going though code review. The NGI team is currently experimenting with the infrastructure aspect on https://ngi.nixos.org and we’re iterating on making the contribution process more convenient. But up-to-date and correct documentation has the cost of rigor, that won’t go away…19:58:59
17 May 2025
@lorev:matrix.org@lorev:matrix.org joined the room.09:47:56
@mjolnir:nixos.orgNixOS Moderation Bot banned @mightyiam:matrix.org@mightyiam:matrix.org (persistent time-wasting).23:30:24
19 May 2025
@pkharvey:defenestrate.itpkharvey set a profile picture.21:33:33
@pkharvey:defenestrate.itpkharvey changed their profile picture.21:35:30
21 May 2025
@shadowrz:nixos.devYorusaka Miyabi changed their display name from Yorusaka Miyabi [DO NOT DM] to Yorusaka Miyabi.16:25:53
23 May 2025
@adfaure:matrix.orgAdrien 🦄Hi everyone, quick question about the documentation. I had to provide info on overlays but couldn’t find anything official. Only the NixOS wiki page (https://nixos.wiki/wiki/Overlays). Is there an official source I missed? If not, would it make sense to add something?13:06:07

Show newer messages


Back to Room ListRoom Version: 6