!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

402 Members
Discussion about documentation improvements around the Nix ecosystem82 Servers

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


SenderMessageTime
16 Mar 2024
@danielsidhion:nixos.devdanielsidhionDepending on what we find (and this will mostly only matter after we finish looking at the options we have on our list), we might need a specific tool for manpage building anyway, and if that tool can do fast html for in-your-os, then that would be cool too04:08:50
@infinisil:matrix.orginfinisilAlso nixos-render-docs is like really fast already.. a couple seconds04:09:09
@infinisil:matrix.orginfinisil * Also nixos-render-docs is like really fast already.. a couple seconds!04:09:11
@danielsidhion:nixos.devdanielsidhionA bunch of options we found that we're looking into say that they build manpages as well with plugins, but how good those things are is yet to be determined04:09:45
@jade_:matrix.org@jade_:matrix.org i still can't understand why everyone's immediate thought is constantly to replace nrd other than for lack of desire to look at the code and how it can achieve the goals set out  04:09:52
@danielsidhion:nixos.devdanielsidhionI agree with the other arguments though - python is more approachable than c04:10:07
@jade_:matrix.org@jade_:matrix.org (for what it's worth i would be very suspicious of any man page generation plugin) 04:10:08
* @infinisil:matrix.orginfinisil agrees with giving nrd a fairer try. Having looked at the code base, it seems very approachable04:10:46
@jade_:matrix.org@jade_:matrix.org (generally man page generators (especially if they are bolted on the side of something else) are very very much trying to fit something that's not a man page into the shape of a man page and not considering the range of semantic expressiveness of the format) 04:11:26
@danielsidhion:nixos.devdanielsidhion
In reply to @jade_:matrix.org
i still can't understand why everyone's immediate thought is constantly to replace nrd other than for lack of desire to look at the code and how it can achieve the goals set out 
I've looked at the code already, and the effort to get it to where I'd like it to be is not insignificant
04:11:42
@danielsidhion:nixos.devdanielsidhionWhich is why I'm looking at other options too04:11:55
@rina/:matrix.orgkaitnow for my main motivation for joining: what happened to the main manual? is there any announcement or documentation regarding the changes?04:25:16
@infinisil:matrix.orginfinisil kait/: Oh you mean because it looks different now? 04:25:43
@rina/:matrix.orgkaitit does!04:25:50
@infinisil:matrix.orginfinisil kait/: That's a regression caused by the marketing team, see https://github.com/NixOS/nixos-homepage/issues/1251, unfortunately it was ignored.. 04:27:04
@infinisil:matrix.orginfinisil danielsidhion here is the hero stepping in with a fix in https://github.com/NixOS/nixpkgs/pull/295847 🚀 04:28:09
@rina/:matrix.orgkaitoh gosh!04:28:51

Show newer messages


Back to Room ListRoom Version: 6