!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

427 Members
Discussion about documentation improvements around the Nix ecosystem85 Servers

Load older messages


SenderMessageTime
11 Jun 2023
@pennae:matrix.eno.space@pennae:matrix.eno.spaceah, that may have been the missing bit. we didn't add a title at all15:47:02
@pennae:matrix.eno.space@pennae:matrix.eno.spacepandoc docs make it look like that's not needed and the original didn't have a title either, so that wouldn't've done any good to minimize the diff anyway15:48:07
@proofconstruction:matrix.orgproofconstructionwhy would we need to "adopt" rust to use mdbook? we're not building the mdbook binary every time we render the docs (i hope)15:55:01
@pennae:matrix.eno.space@pennae:matrix.eno.spaceci might15:56:49
@pennae:matrix.eno.space@pennae:matrix.eno.space

just did a little test on manual build times after changes:

19.03     0:37
19.09     0:39
20.03     0:44
20.09     0:51
21.05     1:07
21.11     1:22
22.05     1:39
22.11     1:55
23.05     1:00
-docbook  0:13
16:07:43
@pennae:matrix.eno.space@pennae:matrix.eno.space that's timing the nix-build call that builds the manual, so the actual improvement in the manual build is going to be larger than it seems here 16:08:16
@pennae:matrix.eno.space@pennae:matrix.eno.spacethe final run spent half of its time in nix itself16:10:46
@pennae:matrix.eno.space@pennae:matrix.eno.space https://github.com/NixOS/nixpkgs/pull/237237
begone, foul simulacrum of paper
19:23:25
12 Jun 2023
@Ericson2314:matrix.orgJohn Ericsonhttps://git-scm.com/book/en/v2/Git-Internals-Git-Objects14:44:57
13 Jun 2023
@pennae:matrix.eno.space@pennae:matrix.eno.space https://github.com/NixOS/nixpkgs/pull/237557 there we go. nixos manual sans docbook 12:42:43
@pennae:matrix.eno.space@pennae:matrix.eno.spaceand nixpkgs isn't that far behind at this point12:42:51
@pennae:matrix.eno.space@pennae:matrix.eno.spacewe've got nixpkgs mostly done, just needs a few more changes to nixdoc that we'll take care of before too long (hopefully)12:49:05
@mrcjk:matrix.orgMarc Jakobi changed their profile picture.14:49:40
@julienmalka:matrix.orgJulien changed their display name from Julien to JulienMalka (stop speaking german when).14:53:11
@julienmalka:matrix.orgJulien changed their display name from JulienMalka (stop speaking german when) to Julien (stop speaking german when).14:53:49
@federicodschonborn:matrix.org@federicodschonborn:matrix.org changed their profile picture.20:55:52
@julienmalka:matrix.orgJulien changed their display name from Julien (stop speaking german when) to Julien.21:05:24
14 Jun 2023
@hexa:lossy.networkhexa left the room.16:14:58
@zmitchell:matrix.org@zmitchell:matrix.org
In reply to @pennae:matrix.eno.space
https://github.com/NixOS/nixpkgs/pull/237557 there we go. nixos manual sans docbook
It was at this point I realized I never made a "This Month in Nix Docs" for May 🤦‍♂️
16:20:26
@asymmetric:matrix.dapp.org.ukasymmetric
In reply to @pennae:matrix.eno.space
we've got nixpkgs mostly done, just needs a few more changes to nixdoc that we'll take care of before too long (hopefully)
What changes are you thinking of?
20:26:42
@pennae:matrix.eno.space@pennae:matrix.eno.space
In reply to @asymmetric:matrix.dapp.org.uk
What changes are you thinking of?
basically this sans escaping https://github.com/pennae/nixpkgs/blob/nixpkgs-manual-nrd/pkgs/tools/nix/nixdoc/default.nix
20:28:25
@pennae:matrix.eno.space@pennae:matrix.eno.spaceescaping is only in there for diff reasons20:28:33
@asymmetric:matrix.dapp.org.ukasymmetricCool, let me know when you have a PR ready :)20:34:37
@pennae:matrix.eno.space@pennae:matrix.eno.spacehopefully soon20:34:50
@pennae:matrix.eno.space@pennae:matrix.eno.spacewant to be done with this stuff tbh20:34:59
@asymmetric:matrix.dapp.org.ukasymmetricI’ve just added snapshot testing, so we’ll need to update the snapshot in the PR too20:35:29
@pennae:matrix.eno.space@pennae:matrix.eno.space
In reply to @asymmetric:matrix.dapp.org.uk
I’ve just added snapshot testing, so we’ll need to update the snapshot in the PR too
should be no problem. will have to see if we need any more changes to make the docs port feasibly reviewable without changing the output too much, but looks like that should be it (or at least close)
21:05:13
15 Jun 2023
@badele:matrix.orgBruno Adele joined the room.07:06:40
@mon:tchncs.depneumatic joined the room.16:39:53
@pennae:matrix.eno.space@pennae:matrix.eno.spacewhat kind of stuff still needs to be done on the docs infra side, assuming that the docbook transition is over and nixos-render-docs is provisionally complete?18:08:08

Show newer messages


Back to Room ListRoom Version: 6