Nix Documentation | 396 Members | |
| Discussion about documentation improvements around the Nix ecosystem | 80 Servers |
| Sender | Message | Time |
|---|---|---|
| 21 May 2024 | ||
| It's office hours again! https://jitsi.lassul.us/nix-documentation | 19:01:35 | |
In reply to @sandro:supersandro.dealejandrosame and me undid the overengineering, ready for review now: https://github.com/NixOS/nixpkgs/pull/313408 | 21:47:13 | |
| 22 May 2024 | ||
| fricklerhandwerk: alejandrosame I took a look through the code and wrote a comment with a simplified version of the code. Let me know what you all think. | 06:41:06 | |
In reply to @djacu:matrix.orgCool, thanks a lot. Some good ideas to further boil it down | 06:50:34 | |
| 15:26:03 | ||
| 15:28:17 | ||
| 17:32:09 | ||
| 23 May 2024 | ||
| Documentation office hours in 18 minutes: https://jitsi.lassul.us/nix-documentation | 14:12:59 | |
| 25 May 2024 | ||
| 10:43:58 | ||
| 👋 I'm a low-ish knowledge nix user & I have an idea to improve the onboarding / learning experience. What is the best thing for me to read to understand your preferred way to receive such suggestions? The tldr is I've landed at https://github.com/NixOS/nix/blob/e0c94b91ee7b8dd30e669228c01f1b75179f1903/src/libcmd/installable-flake.cc#L195 . My fight back to where I should be is massively more difficult that it should be. I suspect I'm the exact class/type of idiot we should be able to make more productive here 🤣. As an aside, I saw a recent post about looking for folks to help with docs and blew it off, but apparently the universe has other ideas, and here I am 😅 | 17:51:29 | |
In reply to @enn_:matrix.orgWelcome! For suggestions, typically they are made here, in a GitHub Issue, or by implementing the change and making a pull request to the appropriate repository. In all cases there will be an associated thread of comments and follow up suggestions. | 19:46:58 | |
| 27 May 2024 | ||
| 12:12:10 | ||
| 28 May 2024 | ||
| 00:25:43 | ||
Download image.png | 22:30:29 | |
| https://nixos.org/nix/manual/ | 22:30:32 | |
| ^ this is the top link for the search "nix manual" | 22:31:21 | |
| Trying to redeploy to Netlify, but we have some auth problems. Rok has access. | 22:39:46 | |
| https://github.com/NixOS/nixos-homepage/actions/runs/9274765717/job/25520216514#step:6:22 | 22:40:15 | |
| The PR to fix it has been merged. | 22:40:46 | |
| 29 May 2024 | ||
| Looks like intra-manual redirects are borked too: https://nix.dev/manual/nix/2.13/expressions/language-constructs.html#functions redirects to https://nix.dev/manual/nix/2.13/language/language-constructs.html#functions instead of https://nix.dev/manual/nix/2.13/language/constructs#functions | 07:20:48 | |
| Apparently, this https://github.com/NixOS/nixos-homepage/pull/881 has not been ported to nix.dev fricklerhandwerk | 07:26:20 | |
In reply to @jtojnar:matrix.orgPossibly. That redirect logic is now in the Nix manual, apparently I didn't backport the changes far enough into the past | 07:27:46 | |
| If anyone's interested I'll be in https://jitsi.lassul.us/nix-documentation in 30 min and take care of it | 07:28:31 | |
| hmm, weird, the rule is there https://github.com/NixOS/nix/blob/2bd66922eef1c41e74efe1cca722b0ee7d640af1/doc/manual/src/_redirects#L26 | 07:31:31 | |
| but for some reason it appears to take the fallback branch | 07:31:55 | |
hmm, probably because of the .html suffix | 07:33:31 | |
| https://nix.dev/manual/nix/2.13/language/constructs.html | 08:17:06 | |
| * Looks like the pretty URLs does not do canonization. Here is a valid URL with HTML suffix – there is no redirect to strip it: https://nix.dev/manual/nix/2.13/language/constructs.html | 08:19:06 | |
| The situation is pretty cursed due to how I messed up the situation before merging the (hopefully final) fix. Jan Tojnar and I just looked into it and there is no meaningful hotfix except waiting nixos.org to be deployed. Redirects with | 08:51:24 | |
| * The situation is pretty cursed due to how I messed up the situation before merging the (hopefully final) fix. Jan Tojnar and I just looked into it and there is no meaningful hotfix except waiting for nixos.org to be redeployed. Redirects with | 08:51:35 | |