!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

412 Members
Discussion about documentation improvements around the Nix ecosystem86 Servers

Load older messages


SenderMessageTime
25 May 2024
@proofconstruction:matrix.orgproofconstruction
In reply to @enn_:matrix.org
👋 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 😅
Welcome! 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
@fricklerhandwerk:matrix.orgfricklerhandwerk changed the room topic to "This is the official channel for documentation in the Nix ecosystem. The documentation team meets here. More information: https://nixos.org/community/teams/documentation NixOS teams calendar: https://calendar.google.com/calendar/embed?src=b9o52fobqjak8oq8lfkhg3t0qg%40group.calendar.google.com Documentation office hours are open for anyone interested in solving problems, getting contributions reviewed in real time, or becoming a maintainer. Video conference: https://jitsi.lassul.us/nix-documentation Meeting notes scratch pad: https://pad.lassul.us/p-Y8MjU2SdSD5qO1fnpCPA Past meeting notes: https://discourse.nixos.org/search?q=documentation%20team%20meeting%20order%3Alatest " from "This is the official channel for documentation in the Nix ecosystem. The documentation team meets here. More information: https://nixos.org/community/teams/documentation Video conference: https://jitsi.lassul.us/nix-documentation Meeting notes scratch pad: https://pad.lassul.us/p-Y8MjU2SdSD5qO1fnpCPA Past meeting notes: https://discourse.nixos.org/search?q=documentation%20team%20meeting%20order%3Alatest NixOS teams calendar: https://calendar.google.com/calendar/embed?src=b9o52fobqjak8oq8lfkhg3t0qg%40group.calendar.google.com&ctz=Europe%2FBerlin".12:12:10
28 May 2024
@willbush:matrix.orgwillbush joined the room.00:25:43
@ryantm:matrix.orgryantmimage.png
Download image.png
22:30:29
@ryantm:matrix.orgryantmhttps://nixos.org/nix/manual/22:30:32
@ryantm:matrix.orgryantm^ this is the top link for the search "nix manual"22:31:21
@tomberek:matrix.orgtomberekTrying to redeploy to Netlify, but we have some auth problems. Rok has access.22:39:46
@tomberek:matrix.orgtomberekhttps://github.com/NixOS/nixos-homepage/actions/runs/9274765717/job/25520216514#step:6:2222:40:15
@tomberek:matrix.orgtomberekThe PR to fix it has been merged. 22:40:46
29 May 2024
@jtojnar:matrix.orgJan TojnarLooks 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#functions07:20:48
@jtojnar:matrix.orgJan Tojnar Apparently, this https://github.com/NixOS/nixos-homepage/pull/881 has not been ported to nix.dev fricklerhandwerk 07:26:20
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @jtojnar:matrix.org
Apparently, this https://github.com/NixOS/nixos-homepage/pull/881 has not been ported to nix.dev fricklerhandwerk
Possibly. That redirect logic is now in the Nix manual, apparently I didn't backport the changes far enough into the past
07:27:46
@fricklerhandwerk:matrix.orgfricklerhandwerkIf anyone's interested I'll be in https://jitsi.lassul.us/nix-documentation in 30 min and take care of it07:28:31
@jtojnar:matrix.orgJan Tojnarhmm, weird, the rule is there https://github.com/NixOS/nix/blob/2bd66922eef1c41e74efe1cca722b0ee7d640af1/doc/manual/src/_redirects#L2607:31:31
@jtojnar:matrix.orgJan Tojnarbut for some reason it appears to take the fallback branch07:31:55
@jtojnar:matrix.orgJan Tojnar hmm, probably because of the .html suffix 07:33:31
@jtojnar:matrix.orgJan Tojnarhttps://nix.dev/manual/nix/2.13/language/constructs.html08:17:06
@jtojnar:matrix.orgJan Tojnar * 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.html08:19:06
@fricklerhandwerk:matrix.orgfricklerhandwerk

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 .html suffixes seem not to work because maybe nix.dev doesn't have Netlify Pretty URLs enabled - or maybe the feature doesn't work as one would expect, or maybe it interacts in weird ways with redirects. This is all very confusing

08:51:24
@fricklerhandwerk:matrix.orgfricklerhandwerk *

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 .html suffixes seem not to work because maybe nix.dev doesn't have Netlify Pretty URLs enabled - or maybe the feature doesn't work as one would expect, or maybe it interacts in weird ways with redirects. This is all very confusing

08:51:35
@fricklerhandwerk:matrix.orgfricklerhandwerk *

The situation is pretty cursed due to how I messed it up 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 .html suffixes seem not to work because maybe nix.dev doesn't have Netlify Pretty URLs enabled - or maybe the feature doesn't work as one would expect, or maybe it interacts in weird ways with redirects. This is all very confusing

08:52:17
@hexa:lossy.networkhexa joined the room.09:06:16
@janne.hess:helsinki-systems.de@janne.hess:helsinki-systems.de Not sure if this has been reported already but google tends to give me URLs like https://nixos.org/manual/nix/unstable/language/builtins which redirect and 404 now 09:55:14
@fricklerhandwerk:matrix.orgfricklerhandwerk Janne Heß: Yes, literally the handful prior messages 10:46:26
@fricklerhandwerk:matrix.orgfricklerhandwerk * Janne Heß: Yes, literally the handful of prior messages 10:46:35
@janne.hess:helsinki-systems.de@janne.hess:helsinki-systems.de
In reply to @fricklerhandwerk:matrix.org
Janne Heß: Yes, literally the handful of prior messages
Sorry, I was in a rush and overlooked them :/
10:54:20
@raitobezarius:matrix.orgraitobezarius changed their display name from raitobezarius to raitobezarius (DECT: 7248).17:10:53
@fricklerhandwerk:matrix.orgfricklerhandwerkSeems to be fixed now, thanks to whoever!21:38:09
30 May 2024
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @jtojnar:matrix.org
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
That particular bit is still broken, will look into it in a quiet minute
06:30:30
1 Jun 2024
@rina/:matrix.orgkait changed their display name from kait/ to speepy.08:52:50

Show newer messages


Back to Room ListRoom Version: 6