| 8 Mar 2024 |
 @pennae:matrix.eno.space | (we also find it somewhat backhanded to come up with live editing again when that was already hacked into place and not even possible before the md workflow really took off) | 08:07:44 |
| @pennae:matrix.eno.space | like, the root problem with our docs isn't tooling support. switching out tooling again will only bind resources that could've been used for something that actually improves that status quo? | 08:08:54 |
 infinisil | In reply to @jade_:matrix.org
It seems borderline absurd to assume that there exists an off the shelf solution that actually has proper interactions with nix and consideration of anything that is not a web browser. Have you considered taking the nrd output and using it in your pipeline instead of trying to reinvent it, so we actually own the markup parser and such? Afaik there's nothing Nix-specific about nixos-render-docs at least | 09:45:49 |
| infinisil | In reply to @pennae:matrix.eno.space
like, the root problem with our docs isn't tooling support. switching out tooling again will only bind resources that could've been used for something that actually improves that status quo? I'd say it's a problem that we use different tooling for different projects. I guess it would make sense to try and see if nixos-render-docs could be used throughout though (such as for Nix and nix.dev). | 09:48:07 |
| @pennae:matrix.eno.space | not nix-specific, but nixpkgs/nixos-specific very much so. like manpage export, integration with the option system, crossreferencing, even performance optimizations needed to generate such huge documents as the nixos manual | 09:48:23 |
| @pennae:matrix.eno.space | In reply to @infinisil:matrix.org
I'd say it's a problem that we use different tooling for different projects. I guess it would make sense to try and see if nixos-render-docs could be used throughout though (such as for Nix and nix.dev). we did have that aspiration before we burned out on it all | 09:48:54 |
| infinisil | In reply to @pennae:matrix.eno.space
not nix-specific, but nixpkgs/nixos-specific very much so. like manpage export, integration with the option system, crossreferencing, even performance optimizations needed to generate such huge documents as the nixos manual Integration with the option system sounds very interesting, can you link to that? | 09:49:15 |
| infinisil | Oh I guess options.py | 09:49:23 |
