!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

414 Members
Discussion about documentation improvements around the Nix ecosystem84 Servers

Load older messages


SenderMessageTime
30 Jun 2023
@pennae:matrix.eno.space@pennae:matrix.eno.spacewe do check, and it has failed in the past17:04:26
@pennae:matrix.eno.space@pennae:matrix.eno.spaceat least now it can tell you where shit broke instead of having relaxng slap you with entirely incorrect error locations and messages that aren't worth the photons they're imprinted on17:05:41
1 Jul 2023
@pennae:matrix.eno.space@pennae:matrix.eno.spacenixdoc changes for nixpkgs markdowning are merged 🥳12:42:41
@pennae:matrix.eno.space@pennae:matrix.eno.spacegoing to update the nixpkgs-side pr in a bit so we can hopefully get that done within the next week12:43:05
@pennae:matrix.eno.space@pennae:matrix.eno.space https://github.com/NixOS/nixpkgs/pull/239636 preliminarily final pr for getting rid of docbook. that really should be it for the entirety of the nixpkgs repo, unless we missed something that's buried deep under the ice 14:13:11
@pennae:matrix.eno.space@pennae:matrix.eno.spacehome stretch! 🎉18:59:06
3 Jul 2023
@zmitchell:matrix.org@zmitchell:matrix.orghttps://discourse.nixos.org/t/this-month-in-nix-docs-3-may-june-2023/2995816:56:29
@zmitchell:matrix.org@zmitchell:matrix.orgFeel free to post a comment if I got something wrong16:57:06
@pennae:matrix.eno.space@pennae:matrix.eno.spacedamn, has it been two months again 😨17:00:18
@zmitchell:matrix.org@zmitchell:matrix.org I too forgot that time marches forward regardless of my protests 17:01:37
@pennae:matrix.eno.space@pennae:matrix.eno.spacefwiw the docbook toolchain also allows fragmenting a document into multiple outputs (nixos manual and epubs used that), but it's horrid to configure and still all docbook :/17:20:07
@pennae:matrix.eno.space@pennae:matrix.eno.space moving away from xhtml outputs going to fun. ncfavier, any idea how much that would break? 17:20:51
@pennae:matrix.eno.space@pennae:matrix.eno.spaceeg, does nixos-search use docbook/xhtml?17:21:39
@pennae:matrix.eno.space@pennae:matrix.eno.spacethe homepage runs xslt over manual xhtml, which is going to ... Great 😞17:22:39
@ncfavier:matrix.orgnf
In reply to @pennae:matrix.eno.space
eg, does nixos-search use docbook/xhtml?
i don't think so
17:37:04
@pennae:matrix.eno.space@pennae:matrix.eno.spacethat's good already :)17:38:14
@ncfavier:matrix.orgnfwe just render (previously docbook/) markdown snippets to html with pandoc. btw, it would be nice if we could use nixos-render-docs to do that17:38:18
@ncfavier:matrix.orgnfthat way we don't need to keep link-manpages.nix around17:38:39
@pennae:matrix.eno.space@pennae:matrix.eno.spacethat pretty much just needs a new options render mode that returns a collection of fragments instead of a document, shouldn't be that much work17:39:14
@pennae:matrix.eno.space@pennae:matrix.eno.spacethe infra needed to do that is there and used internally to speed up options rendering, it pretty much only needs exported as a mode17:39:48
@pennae:matrix.eno.space@pennae:matrix.eno.space would still like to remove link-manpages.nix from nixpkgs soon, or rather: get that pr merged so it can't diverge and need rework 17:44:42
@m52957:matrix.orgNate joined the room.18:02:38
@ncfavier:matrix.orgnfon it18:11:17
@pennae:matrix.eno.space@pennae:matrix.eno.spaceawesome 💜18:12:58
@pennae:matrix.eno.space@pennae:matrix.eno.spacethanks!18:48:38
@pennae:matrix.eno.space@pennae:matrix.eno.spaceand now docbook is no longer 😌18:48:50
@jtojnar:matrix.orgJan Tojnargreat job19:01:04
@pennae:matrix.eno.space@pennae:matrix.eno.spacethere's a lot of issues that can be closed now19:03:26
4 Jul 2023
@asymmetric:matrix.dapp.org.ukasymmetricso has the markdown manual been deployed to nixos.org?09:01:20
@asymmetric:matrix.dapp.org.ukasymmetricor when will that happen?09:01:34

Show newer messages


Back to Room ListRoom Version: 6