!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

430 Members
Discussion about documentation improvements around the Nix ecosystem86 Servers

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


SenderMessageTime
12 Jan 2024
@jade_:matrix.org@jade_:matrix.orgthis one, which claims to "complete autogenerated documentation for the whole nix-ecosystem" (which is fundamentally contradictory with all the other projects ostensibly doing this but having nothing to do with it): https://github.com/nix-community/docnix20:53:12
@jade_:matrix.org@jade_:matrix.orgthe description of this and how it fits into the way everything is going to fit together is very fundamentally confusing20:53:54
@jade_:matrix.org@jade_:matrix.org and i guess this is part of a meta thing of "we aren't tracking how all the new docs stuff is fitting together and what we actually want from a docs generation system that fulfils all requirements" 20:55:01
@jade_:matrix.org@jade_:matrix.org(for the record i don't think that we are going to get away with having something that doesn't have very substantial amounts of our own code, in spite of what may have been said about that objective in the past re using sphinx or such. at the very least we will have to have a plugin or such)20:56:26
@jade_:matrix.org@jade_:matrix.org
In reply to @asymmetric:matrix.dapp.org.uk
mainly because, afaict, nrd is the sanctioned way forward
gosh we need to write these things down in a durable location that is not a github issue. we need a not-necessarily-wiki but easily modified, page that states that decision, and in general an overview of the tooling and its plans
20:59:24

Show newer messages


Back to Room ListRoom Version: 6