!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

431 Members
Discussion about documentation improvements around the Nix ecosystem89 Servers

You have reached the beginning of time (for this room).


SenderMessageTime
8 Mar 2024
@pennae:matrix.eno.spacepennae
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:matrix.orginfinisil
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:matrix.orginfinisilOh I guess options.py09:49:23
@pennae:matrix.eno.spacepennae
In reply to @infinisil:matrix.org
Oh I guess options.py
correct
09:50:04
@infinisil:matrix.orginfinisilhttps://github.com/NixOS/nixpkgs/blob/master/pkgs/tools/nix/nixos-render-docs/src/nixos_render_docs/options.py09:50:19
@infinisil:matrix.orginfinisilOh so it renders it a bit differently on different targets09:50:31
@pennae:matrix.eno.spacepennaeof course, that's why the manpage isn't terrible09:50:57

Show newer messages


Back to Room ListRoom Version: 6