!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

406 Members
Discussion about documentation improvements around the Nix ecosystem80 Servers

Load older messages


SenderMessageTime
20 Dec 2023
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @danielsidhion:nixos.dev
Made a PR to add some extra info on a particular section of the testers chapter in the manual, and I noticed that the other sections there aren't using the newer example syntax, so my changes look a bit out of place. I could just move all examples in that chapter to the new syntax, but idk if it'd be ok to do it all in the same PR. Appreciate any thoughts: https://github.com/NixOS/nixpkgs/pull/275585
(I'll also be able to join the next meeting, so we could chat quickly about it there)
Nice one! Please don't do unrelated things in the same PR. A separate PR for a mechanical change is quick to review and merge independently.
10:46:50
@bzzm3r:matrix.org@bzzm3r:matrix.org

infinisil: (and others relevant) Based on my interpretation/understanding of how meetings work, I updated the collaborative scratchpad with agenda notes for the next meeting related to an issue that fricklerhandwerk invited me to discuss.

Please feel free to correct it/move it, if I have misunderstood where it is supposed to land.

I am not yet sure if I will show up to the meeting, due to other issues.

22:50:18
@infinisil:matrix.orginfinisil bzm3r: Sounds good to me :) 22:53:19
21 Dec 2023
@danielsidhion:nixos.devdanielsidhionFollow up PR to my previous question: migration of the other examples in this chapter to the new example style. I could use some help figuring out how to migrate that last example in the chapter. Too many names and concepts super close to each other making it harder. https://github.com/NixOS/nixpkgs/pull/27579108:51:48
@bzzm3r:matrix.org@bzzm3r:matrix.orgdoes the meeting usually start a little late? 😅15:05:26
@danielsidhion:nixos.devdanielsidhionhttps://jitsi.lassul.us/nix-documentation This is the link15:06:28
@bzzm3r:matrix.org@bzzm3r:matrix.orgso this is the wrong link: https://meet.jit.si/nix-documentation!15:08:10
@bzzm3r:matrix.org@bzzm3r:matrix.org
In reply to @bzzm3r:matrix.org
so this is the wrong link: https://meet.jit.si/nix-documentation!
(this is in the readme)
15:08:22
@bzzm3r:matrix.org@bzzm3r:matrix.orgah wait, that is because I was looking at the wrong commit 😆15:12:37
22 Dec 2023
@danielsidhion:nixos.devdanielsidhionI just started on my quest to modernize all the examples in the manual with the new admonition syntax, and the first file I opened ended up having a bunch of outdated and unneeded information, so I decided to take a bit more time and figure out the history of the changes and document things better: https://github.com/NixOS/nixpkgs/pull/27602910:59:26
@danielsidhion:nixos.devdanielsidhionI hope not all files end up like this lol But the information on this one was pretty easy to understand by following a couple PR links and searching things on nixpkgs, so I ended up doing an almost full rewrite of the section. Apologies for the added scope.11:00:37
@danielsidhion:nixos.devdanielsidhion(as a bonus, all examples in the file are full working examples - if I see the opportunity, I might continue doing things this way to make it easier in the future if/when we decide to start testing all examples in the manuals to make sure they work)11:02:27
@infinisil:matrix.orginfinisil danielsidhion: This is great! 11:32:39
@danielsidhion:nixos.devdanielsidhion Also when going through this, I'm starting to create issues for extra work that is either more than I can do at the moment, or is stuff that I'd try to revisit at some point. It improves either the documentation or stuff in Nixpkgs, and I think it's the sort of thing bzm3r would love to have to work on issues with very specific scope. Here are two issues I opened from my rewrite of that section:
https://github.com/NixOS/nixpkgs/issues/276033
https://github.com/NixOS/nixpkgs/issues/276034
11:34:35
23 Dec 2023
@raitobezarius:matrix.orgraitobezarius changed their display name from raitobezarius to raitobezarius (DECT 2128).22:22:41
24 Dec 2023
@bzzm3r:matrix.org@bzzm3r:matrix.org
In reply to @danielsidhion:nixos.dev
Also when going through this, I'm starting to create issues for extra work that is either more than I can do at the moment, or is stuff that I'd try to revisit at some point. It improves either the documentation or stuff in Nixpkgs, and I think it's the sort of thing bzm3r would love to have to work on issues with very specific scope. Here are two issues I opened from my rewrite of that section:
https://github.com/NixOS/nixpkgs/issues/276033
https://github.com/NixOS/nixpkgs/issues/276034
danielsidhion: thank you! (I'm also very glad that you did decide to ping me re: looking into these issues)
08:26:58
@bzzm3r:matrix.org@bzzm3r:matrix.org(so please feel free to continue to ping me on such stuff, both here, and on GitHub)08:28:52
@bzzm3r:matrix.org@bzzm3r:matrix.org * (so please continue to ping me on such stuff, both here, and on GitHub)08:29:10
@jkxyz:matrix.org@jkxyz:matrix.org set a profile picture.18:12:55
25 Dec 2023
@julienmalka:matrix.orgJulien changed their display name from Julien to Julien - DECT 4575.20:03:43
26 Dec 2023
@danielsidhion:nixos.devdanielsidhionAlso had to change a bit of content on this one, but at a way smaller scale: https://github.com/NixOS/nixpkgs/pull/276821 When working on it, I realised the manual doesn't seem to follow a convention for shell commands and their outputs, and created the following issue to track this: https://github.com/NixOS/nixpkgs/issues/276829 I'll put this issue on the agenda for some meeting next year, but I'm hoping it won't take long to achieve consensus. Once we have one, I can add it to my list of "things to update while I go through every file of the nixpkgs manual".02:03:50
@matthewcroughan:defenestrate.itmatthewcroughan @fosdem changed their display name from matthewcroughan - nix.how to matthewcroughan - Linux 6.7 When.16:48:35
27 Dec 2023
@nikstur:matrix.orgnikstur changed their display name from nikstur to nikstur (DECT 5643).09:49:16
29 Dec 2023
@mcdonc:matrix.orgChris McDonough joined the room.13:03:47
@mcdonc:matrix.orgChris McDonoughhi folks... fyi, i submitted a PR for improving trivial builder text-related functions at https://github.com/NixOS/nixpkgs/pull/277534 ...i'd appreciate it if someone could review it and maybe merge?13:05:23
30 Dec 2023
@asymmetric:matrix.dapp.org.ukasymmetric Robert Hensing (roberth): about https://github.com/NixOS/nixpkgs/pull/167670#issuecomment-1872501084, do you mean that you'd like to see more documentation before this is exposed to users? 10:54:19
@asymmetric:matrix.dapp.org.ukasymmetric * Robert Hensing (roberth): about https://github.com/NixOS/nixpkgs/pull/167670#issuecomment-1872501084, do you mean that you'd like to see more documentation before this is exposed to lots users via 2023 recap? 10:54:32
@asymmetric:matrix.dapp.org.ukasymmetric * Robert Hensing (roberth): about https://github.com/NixOS/nixpkgs/pull/167670#issuecomment-1872501084, do you mean that you'd like to see more documentation before this is exposed to lots of users via 2023 recap? 10:54:42
@roberthensing:matrix.orgRobert Hensing (roberth)Just to set expectations in the recap10:54:44
@roberthensing:matrix.orgRobert Hensing (roberth)I think it's sufficiently documented10:54:53

Show newer messages


Back to Room ListRoom Version: 6