| 2 Mar 2024 |
 Minijackson | danielsidhion: I've used Quarto for some of my doc, if you want yet another tool to explore | 19:55:33 |
 danielsidhion | Just to confirm, you mean quarto.org right? | 19:57:06 |
| Minijackson | yes | 19:57:19 |
| Minijackson | https://epics-extensions.github.io/EPNix/ if you want an example | 19:57:53 |
| danielsidhion | Ty | 19:58:10 |
 Dominic Mills | In reply to @jade_:matrix.org
it has bad search and is not designed as a docs website, so you have a bunch of extraneous stuff around that's not relevant to the docs. their markdown renderer isn't bad but eh we can have nicer things than GitHub This actually might make a decent Google Season of Docs proposal 😃. I remember seeing this Summer of Code project for automating Puppeteer's docs (https://gist.github.com/tasneemkoushar/941128bc0d04f095fa01a5334617c65b) which incorporated search features using algolia. Nix doesn't have nice enough tooling to make this feasible, since to the best of my knowledge, the only thing we have to automating the generation of docs is nixdoc (https://github.com/nix-community/nixdoc) which is nice but leaves a lot to be desired. | 20:13:22 |
 @jade_:matrix.org | nope theres another new one | 20:13:43 |
| @jade_:matrix.org | after the rfc | 20:13:47 |
| @jade_:matrix.org | i think it is now under nix-community | 20:13:53 |
| 3 Mar 2024 |
 Lurkki | 
Download clipboard.png | 14:03:53 |
| Lurkki | How can I render the docs into HTML locally? | 14:04:03 |
| Lurkki | In reply to @lurkki:pikaviestin.fi
How can I render the docs into HTML locally? Ah, noticed it's in a separate package | 14:11:56 |
| Lurkki | * Ah, noticed the renderer is in a separate package | 14:12:13 |
| 5 Mar 2024 |
| danielsidhion | Conflicted about something: in its current state, snapTools.makeSnap produces broken snaps. With a patch, it works only for static binaries, but I haven't figured out a way to make it work in more general cases, and the spec leads me to believe that making it work will be very hard. Do I put in the nixpkgs manual that makeSnap is broken as-is, but still document the function normally? Do I just remove it from the manual entirely and proceed with removing the code for makeSnap? Looks like it's been broken since late 2020 according to this issue: https://github.com/NixOS/nixpkgs/issues/100618 | 01:42:12 |
 infinisil | danielsidhion: I'd be in favor of removing, or rather replacing with an error saying why it was removed. That error could also link to that issue | 03:01:18 |
 Philip Taron (UTC-8) | Is there an existing issue or proposal for making :doc (from nix repl) work on more than just builtins? | 18:35:23 |
| @jade_:matrix.org | In reply to @philiptaron:matrix.org
Is there an existing issue or proposal for making :doc (from nix repl) work on more than just builtins? hahahaha lmao | 18:47:27 |
| @jade_:matrix.org | (this is why the nix-doc plugin was created in 2021) | 18:47:40 |
| Philip Taron (UTC-8) | How much ugly history is there? | 18:48:11 |
| @jade_:matrix.org | https://github.com/NixOS/nix/issues/3904 | 18:48:29 |
| @jade_:matrix.org |
I will say, my implementation cannot die to the bikeshed because it cannot in good conscience ever be merged ;-)
| 18:49:02 |
| @jade_:matrix.org | (and indeed it has been working perfectly for the past three and a half years) | 18:49:38 |
 Qyriad | (See also: https://github.com/NixOS/nix/pull/9054) | 18:49:42 |
| @jade_:matrix.org | ^^^ yes | 18:49:52 |
| Philip Taron (UTC-8) | Thank you for the links! | 19:00:43 |
| 6 Mar 2024 |
|  @sammy:cherrykitten.dev joined the room. | 19:04:10 |
|  @ktemkin:katesiria.org joined the room. | 22:25:14 |
| 7 Mar 2024 |
| infinisil | danielsidhion: Are you still there? | 15:57:20 |
| danielsidhion | Brief connection issues | 16:00:36 |
 efx | I have a desire to document a common obstacle I face using nix installed on alternate GNU/Linux distributions. It is practical advice on adding ~/.nix-profile/bin to $PATH using .bashrc.
Is there an ideal place to put this kind of documentation? | 17:20:38 |
