| 4 Jan 2024 |
 danielsidhion | infinisil: PR to document the conventions as discussed in the meeting: https://github.com/NixOS/nixpkgs/pull/278762
I've been adding this documentation-reviewers team on my PRs because it seems more appropriate than adding the documentation team. Is this appropriate, or should I just stick to adding the documentation team instead? | 20:05:59 |
 infinisil | danielsidhion: No that's perfect :) | 20:06:38 |
| danielsidhion | Also as discussed in the meeting, here's a quick overview of what I'm doing: for no reason at all, I decided it would be a good idea to go through the Nixpkgs manual source and update all examples to the admonition syntax as specified in the doc readme. As I did this, I realised that other things could also be updated to follow a more consistent style, and I also started finding a lot of outdated content in the manual, which I'm making an effort to also update. More than one person has asked how they could help, so I created a tracking issue here: https://github.com/NixOS/nixpkgs/issues/278769 | 20:34:17 |
| danielsidhion | Chris McDonough: check the message above. I'm also creating some more issues on the nixpkgs repo for things I find as I read the manual. Those are either for extra documentation, or things in nixpkgs itself. I'd rather not paste a bunch of links here, but you can check issues I opened in the nixpkgs repo (I'm @danielsidhion there too) | 20:36:24 |
| infinisil | danielsidhion: Very nice! | 21:05:55 |
| 5 Jan 2024 |
 asymmetric | In reply to @danielsidhion:nixos.dev
Also as discussed in the meeting, here's a quick overview of what I'm doing: for no reason at all, I decided it would be a good idea to go through the Nixpkgs manual source and update all examples to the admonition syntax as specified in the doc readme. As I did this, I realised that other things could also be updated to follow a more consistent style, and I also started finding a lot of outdated content in the manual, which I'm making an effort to also update. More than one person has asked how they could help, so I created a tracking issue here: https://github.com/NixOS/nixpkgs/issues/278769 I wonder if we could get an LLM do tackle these refactors? It seems pretty algorithmic, and like it should work, but I have no experience with them so I don’t really know | 10:07:39 |
| asymmetric | In reply to @danielsidhion:nixos.dev
Also as discussed in the meeting, here's a quick overview of what I'm doing: for no reason at all, I decided it would be a good idea to go through the Nixpkgs manual source and update all examples to the admonition syntax as specified in the doc readme. As I did this, I realised that other things could also be updated to follow a more consistent style, and I also started finding a lot of outdated content in the manual, which I'm making an effort to also update. More than one person has asked how they could help, so I created a tracking issue here: https://github.com/NixOS/nixpkgs/issues/278769 * I wonder if we could get an LLM to tackle these refactors? It seems pretty algorithmic, and like it should work, but I have no experience with them so I don’t really know | 10:07:55 |
| danielsidhion | The algorithmic part of this effort is too small compared to the human effort still required. I'm also reading and updating the content (biggest effort, since it requires research in most cases, but I consider it outside the scope of the work, I just can't help trying to make things better), making sure the code in the examples can be run (sometimes I have to go find something from nixpkgs instead of going with the generic stuff in some examples), and looking for other things that could be adopted as a convention to bring more consistency to the manual | 11:16:43 |
| danielsidhion | The dockerTools section is very long, so I'm going to create PRs for each subsection. I won't attend the meeting on Monday, but I'd appreciate if you folks could review https://github.com/NixOS/nixpkgs/pull/278956 if you have the time to do it there! | 16:58:46 |
|  @9999years:matrix.org set a profile picture. | 21:01:27 |
| @9999years:matrix.org changed their profile picture. | 21:01:49 |
| 6 Jan 2024 |
|  @oliviacrain:matrix.org joined the room. | 18:07:55 |
| 9 Jan 2024 |
|  matthewcroughan changed their display name from matthewcroughan - Linux 6.7 When to matthewcroughan. | 08:38:33 |
