| 4 Nov 2023 |
 antifuchs | nice! ok, I'll see what I can do (: | 14:46:05 |
| antifuchs | fricklerhandwerk: while I have your attention on the library TOC, do you think it (https://nixos.org/manual/nixpkgs/unstable/#sec-functions-library) should be sorted alphabetically? the order doesn't make much sense to me and that makes it difficult to find things that are missing | 15:03:08 |
 fricklerhandwerk | In reply to @antifuchs:asf.computer
fricklerhandwerk: while I have your attention on the library TOC, do you think it (https://nixos.org/manual/nixpkgs/unstable/#sec-functions-library) should be sorted alphabetically? the order doesn't make much sense to me and that makes it difficult to find things that are missing Sure, I wouldn’t know why not.
Side note: I’m not that involved in the Nixpkgs manual because the Nix manual and nix.dev are enough to deal with, so my knowledge and opinions are quite superficial. There are likely other people who will have more substantial things to say: infinisil Robert Hensing (roberth) @pennae alejandrosame come
to mind. | 15:24:25 |
| antifuchs | oh, haha! I see (: | 15:24:37 |
| antifuchs | would love to hear from you all about that - I have a newfound passion for documenting library functions (: | 15:28:45 |
| antifuchs | here's the first PR, to add the lib.meta attrset of functions to the ToC: https://github.com/NixOS/nixpkgs/pull/265478 | 15:49:25 |
 proofconstruction | Thanks for picking up a shovel! | 15:49:49 |
 @qyriad:matrix.org | I had no idea these functions existed before, so thank you for that! | 15:52:17 |
| antifuchs | I would love to make the ToC be auto-generated with an assertion that when adding a section, a tagline is added too | 17:45:05 |
| antifuchs | (this seems difficult, as the lib/ dir is pretty jumbled) | 18:06:41 |
 @olafklingt:matrix.org | In reply to @antifuchs:asf.computer
here's the first PR, to add the lib.meta attrset of functions to the ToC: https://github.com/NixOS/nixpkgs/pull/265478 maybe this project is interesting to you https://nix-community.github.io/docnix/reference/lib/meta/lib-meta-addmetaattrs/ it builds from a fork of nixpkgs not sure how substantial the difference is. | 18:29:17 |
| antifuchs | Oooh, I didn’t know about that yet! Looks very useful indeed | 18:32:43 |
| 5 Nov 2023 |
|  @atka:matrix.org joined the room. | 01:18:52 |
 infinisil | antifuchs: I do think the order is somewhat important. In particular lib.path, lib.filesystem and lib.sources/lib.fileset should be in that order, because they build up on the previous one | 10:54:23 |
| infinisil | But then again, the path library also isn't that important, maybe it ahould come last :P | 10:55:04 |
| infinisil | I guess I don't care very much tbh :) | 10:55:20 |
| antifuchs | hahaha, makes sense | 14:02:03 |
