!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

409 Members
Discussion about documentation improvements around the Nix ecosystem80 Servers

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


SenderMessageTime
19 Jan 2024
@philipp:xndr.de@philipp:xndr.de I started to document wrapAppImage and I think I've found a few fault points that I'd like to discuss on Tuesday. 14:57:49
20 Jan 2024
@r_i_s:matrix.orgris_ joined the room.12:36:32
@r_i_s:matrix.orgris_https://github.com/NixOS/nixpkgs/pull/273840 hard to get people to review documentation PRs isn't it? ;) 12:37:07
@r_i_s:matrix.orgris_oh balls it has a merge conflict12:37:26
@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.clubSYMYƧ joined the room.23:11:44
@fractivore:cyberia.clubSYMYƧWould 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.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

Show newer messages


Back to Room ListRoom Version: 6