!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

423 Members
Discussion about documentation improvements around the Nix ecosystem86 Servers

Load older messages


SenderMessageTime
16 Mar 2024
@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
@rina/:matrix.orgkaitso it is not permanent (relieved 😌)04:29:14
@danielsidhion:nixos.devdanielsidhion(that PR is just waiting for approvals or more requests for changes btw!)04:29:23
@infinisil:matrix.orginfinisil kait/: Good rule in Nix in general: Things can be shitty for arbitrarily long, untli somebody decides to improve them 04:30:53
@infinisil:matrix.orginfinisil And arbitrary long can be really long, like decades lol 04:31:19
@rina/:matrix.orgkaiti am starting to see that. though, i do not mind pitching in where i can :)04:31:55
@danielsidhion:nixos.devdanielsidhion That PR won't get the manuals to exactly like they were before, but I'd say it gets ~95% of the way there, which is enough to give us time to resume improving the content and keep researching options to find where we want to be in the long term 04:32:50
@ryantm:matrix.orgryantmThe need for a fast and very low dependency tool for building the NixOS manual during builds was the original motivation behind mmdoc.04:40:21
@infinisil:matrix.orginfinisil ryantm: Can you compare the numbers between nrd and mmdoc? 04:41:28
@infinisil:matrix.orginfinisilI don't think nrd is heavy on dependencies, and it seems really fast too04:41:52
@ryantm:matrix.orgryantmDoes someone have nrd building NixOS or Nixpkgs?04:42:24
@ryantm:matrix.orgryantmNixOS or Nixpkgs manuals*04:43:10
@danielsidhion:nixos.devdanielsidhionnrd is the tool that builds them by default right now04:43:21
@danielsidhion:nixos.devdanielsidhion(we shorten it to nrd to avoid writing nixos-render-docs)04:43:42
@ryantm:matrix.orgryantmOh okay. I wasn't aware of the acronym.04:44:14
@ryantm:matrix.orgryantmIt probably won't be a fair comparison since my mmdoc thing isn't doing anything with the options currently.04:45:53
@ryantm:matrix.orgryantm
[ryantm@replit1:~/p/nixpkgs]$ /run/current-system/sw/bin/time nix build --rebuild .#nixpkgs-manual-mmdoc
error: derivation '/nix/store/7fgbi0ril4y59cmfdsnsiv68v044l1h4-nixpkgs-minimal-manual.drv' may not be deterministic: output '/nix/store/zyax\
mgz2lknn4jgd9600g0j9bdxfyjh6-nixpkgs-minimal-manual' differs
Command exited with non-zero status 1
0.06user 0.18system 0:02.05elapsed 12%CPU (0avgtext+0avgdata 25868maxresident)k
0inputs+0outputs (0major+6371minor)pagefaults 0swaps

[ryantm@replit1:~/p/nixpkgs]$ /run/current-system/sw/bin/time nix build --rebuild .#nixos-manual-mmdoc
error: derivation '/nix/store/8288zinh5j2v1w920ra7p5yw5dbp72pl-nixos-minimal-manual.drv' may not be deterministic: output '/nix/store/z2mllr\
8w9wrppxhz8vn87sw1qd3vmb43-nixos-minimal-manual' differs
Command exited with non-zero status 1
0.06user 0.19system 0:01.17elapsed 21%CPU (0avgtext+0avgdata 25840maxresident)k
0inputs+0outputs (0major+6369minor)pagefaults 0swaps
04:50:50
@ryantm:matrix.orgryantmclosures of inputDerivations https://gist.github.com/ryantm/e7fde94d7f0aeb7ebd334015b310b65904:53:53
@ryantm:matrix.orgryantmI don't really know how to run nixos-render-docs will try to learn though.04:57:53
@ryantm:matrix.orgryantmFound the docs on it in the manual :)04:59:49
@ryantm:matrix.orgryantm

After building and adding one newline to manual.md

[ryantm@replit1:~/p/nixpkgs]$ /run/current-system/sw/bin/time nix-build nixos/release.nix -A manual.x86_64-linux
these 3 derivations will be built:
  /nix/store/rdr3b9kqd5qd9rzxqiid68i3znilg95r-lazy-options.json.drv
  /nix/store/s2zkfllzrn4c5610irds9305jwhkn8v9-options.json.drv
  /nix/store/3cjzvv9gfiwvy91gx1awm06771jcbd02-nixos-manual-html.drv
building '/nix/store/rdr3b9kqd5qd9rzxqiid68i3znilg95r-lazy-options.json.drv'...
building '/nix/store/s2zkfllzrn4c5610irds9305jwhkn8v9-options.json.drv'...
building '/nix/store/3cjzvv9gfiwvy91gx1awm06771jcbd02-nixos-manual-html.drv'...
substituteStream(): WARNING: '--replace' is deprecated, use --replace-{fail,warn,quiet}. (file './manual.md')
/nix/store/jpq9yb4lq14war2r2dq8ymigwa6pgdly-nixos-manual-html
1.56user 0.40system 0:08.52elapsed 23%CPU (0avgtext+0avgdata 444068maxresident)k
8inputs+0outputs (0major+107428minor)pagefaults 0swaps
05:01:09
@ryantm:matrix.orgryantmLooks like manual.x86_64-linux does not support the inputDerivation passthru param. 05:04:07
@ryantm:matrix.orgryantm * Looks like manual.x86_64-linux does not support the inputDerivation passthru attribute. 05:04:30

Show newer messages


Back to Room ListRoom Version: 6