Nix Documentation | 406 Members | |
| Discussion about documentation improvements around the Nix ecosystem | 80 Servers |
| Sender | Message | Time |
|---|---|---|
| 20 Dec 2023 | ||
In reply to @danielsidhion:nixos.devNice 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 | |
| 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 | |
| bzm3r: Sounds good to me :) | 22:53:19 | |
| 21 Dec 2023 | ||
| Follow 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/275791 | 08:51:48 | |
| does the meeting usually start a little late? 😅 | 15:05:26 | |
| https://jitsi.lassul.us/nix-documentation This is the link | 15:06:28 | |
| so this is the wrong link: https://meet.jit.si/nix-documentation! | 15:08:10 | |
In reply to @bzzm3r:matrix.org(this is in the readme) | 15:08:22 | |
| ah wait, that is because I was looking at the wrong commit 😆 | 15:12:37 | |
| 22 Dec 2023 | ||
| I 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/276029 | 10:59:26 | |
| I 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 | |
| (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 | |
| danielsidhion: This is great! | 11:32:39 | |
| 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 | ||
| 22:22:41 | ||
| 24 Dec 2023 | ||
In reply to @danielsidhion:nixos.devdanielsidhion: thank you! (I'm also very glad that you did decide to ping me re: looking into these issues) | 08:26:58 | |
| (so please feel free to continue to ping me on such stuff, both here, and on GitHub) | 08:28:52 | |
| * (so please continue to ping me on such stuff, both here, and on GitHub) | 08:29:10 | |
| 18:12:55 | ||
| 25 Dec 2023 | ||
| 20:03:43 | ||
| 26 Dec 2023 | ||
| Also 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 | |
| 16:48:35 | ||
| 27 Dec 2023 | ||
| 09:49:16 | ||
| 29 Dec 2023 | ||
| 13:03:47 | ||
| hi 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 | ||
| 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 | |
| * 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 | |
| * 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 | |
| Just to set expectations in the recap | 10:54:44 | |
| I think it's sufficiently documented | 10:54:53 | |