Nix Documentation | 418 Members | |
| Discussion about documentation improvements around the Nix ecosystem | 84 Servers |
| Sender | Message | Time |
|---|---|---|
| 16 Mar 2024 | ||
| 05:14:26 | |
| Very similar times! | 05:15:03 | |
| Good on you making it that fast with Python :) | 05:16:48 | |
| Looks like it builds an epub and a single page manual. mmdoc is building a multipage, singlepage, man, epub, and search index, but yeah, maybe pretty close overall speed wise. | 05:18:04 | |
| Yeah and closure sizes are also comparable (70MB vs 200MB) | 05:22:36 | |
| Oh wait, I don't think that time is apples to apples:
| 05:22:56 | |
| The manual is already built as the inputDerivation to that derivation. | 05:23:37 | |
| Nix is so hard to benchmark with the all the caching and indirection. | 05:24:40 | |
ryantm: Not sure what you mean, I'm pretty sure nix-build --check pkgs/top-level/release.nix -A manual is the actual build, it's not just a dependency | 05:25:23 | |
| And the command you pasted failed | 05:25:33 | |
| Ah yeah, oops. Okay. | 05:25:53 | |
(gotta build without --check first.. yeah not a great interface) | 05:25:58 | |
| Redacted or Malformed Event | 05:26:59 | |
| Updated the gist again. Looks like the nixpkgs closure is bigger, but the nixpkgs closure matters less. | 05:28:28 | |
| Could you post the results in the github issue? I'm overall not very convinced that this is worth it though ๐ | 05:29:31 | |
| * Could you post the results in the github issue (ideally a nice markdown table with the numbers)? I'm overall not very convinced that this is worth it though ๐ | 05:29:46 | |
| Yeah there's a lot of hate for C. | 05:30:00 | |
| and your thing is already working mostly, though not multipage. | 05:30:23 | |
| Seems reasonable not to switch. | 05:30:26 | |
| I feel kind of bad, you worked on this for so long ๐ | 05:31:07 | |
| I'll take down my multipage manual when we publish official ones. | 05:31:08 | |
| No big deal, I still love the project independent of Nix accepting it. | 05:31:34 | |
| I use it for all my projects and blogs and stuff. | 05:31:44 | |
| I love the easy interface with no config I came up with. | 05:31:59 | |
In reply to @ryantm:matrix.orgI've been told the code is literally there for it, though. so we seem to need to do some wiring.ย | 07:41:14 | |
| 09:23:50 | ||
| (infinisil requested our presence :D) | 09:24:07 | |
In reply to @rina/:matrix.org What would you be interested in taking a closer look at? It would also help knowing what you may have had experience with already, to find something that wonโt overwhelm or frustrate you too quickly. Feel free to DM me if you donโt want this public. Not everything needed to get started is written down nicely yet, so I can offer a brief guided tour of the various construction sites. | 14:06:41 | |
| hm off the top of my head, there are gaps around the trivial script writers - both in terms of documentation and the options they provide | 14:12:30 | |
| i mainly use nix outside nixos, and much of my packaging experience is with C/C++ and cmake. maybe more documentation on dealing with cmake external projects would be useful too | 14:14:06 | |