!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

406 Members
Discussion about documentation improvements around the Nix ecosystem80 Servers

Load older messages


SenderMessageTime
19 Dec 2023
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @asymmetric:matrix.dapp.org.uk
fricklerhandwerk: can you help me understand the redirects file? so for example, here i see a redirect, but if i try to go to the redirected url, it 404s. the same doesn't happen with for exapmle this line, which redirects correctly
The redirects in the Nix manual source have no effect yet. We merged that only recently and the PR to set them up on nix.dev doesn’t work yet because last time I touched it we didn’t have the right Nix builds in the binary cache
17:38:33
@fricklerhandwerk:matrix.orgfricklerhandwerkSo whatever you’re seeing happening on nixos.org is determined by the redirects there17:39:02
@asymmetric:matrix.dapp.org.ukasymmetric
In reply to @fricklerhandwerk:matrix.org
The redirects in the Nix manual source have no effect yet. We merged that only recently and the PR to set them up on nix.dev doesn’t work yet because last time I touched it we didn’t have the right Nix builds in the binary cache
the redirects do have an effect though? we must be talking about different things, because e.g. this line does have an effect, just in a surprising way, i.e. only if there's no .html extension, as i said above
20:37:39
@asymmetric:matrix.dapp.org.ukasymmetric
In reply to @fricklerhandwerk:matrix.org
So whatever you’re seeing happening on nixos.org is determined by the redirects there
ah ok, i get it, the redirect is coming from here
20:43:16
@asymmetric:matrix.dapp.org.ukasymmetric that also explains the .html behavior 20:44:01
20 Dec 2023
@danielsidhion:nixos.devdanielsidhionMade a PR to add some extra info on a particular section of the testers chapter in the manual, and I noticed that the other sections there aren't using the newer example syntax, so my changes look a bit out of place. I could just move all examples in that chapter to the new syntax, but idk if it'd be ok to do it all in the same PR. Appreciate any thoughts: https://github.com/NixOS/nixpkgs/pull/275585 (I'll also be able to join the next meeting, so we could chat quickly about it there)08:04:35
@asymmetric:matrix.dapp.org.ukasymmetrichttps://github.com/executablebooks/sphinx-book-theme/releases/tag/v1.1.009:28:35
@asymmetric:matrix.dapp.org.ukasymmetricnew release of the theme used on nix.dev09:28:43
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @danielsidhion:nixos.dev
Made a PR to add some extra info on a particular section of the testers chapter in the manual, and I noticed that the other sections there aren't using the newer example syntax, so my changes look a bit out of place. I could just move all examples in that chapter to the new syntax, but idk if it'd be ok to do it all in the same PR. Appreciate any thoughts: https://github.com/NixOS/nixpkgs/pull/275585
(I'll also be able to join the next meeting, so we could chat quickly about it there)
Nice one! Please don't do unrelated things in the same PR. A separate PR for a mechanical change is quick to review and merge independently.
10:46:50
@bzzm3r:matrix.org@bzzm3r:matrix.org

infinisil: (and others relevant) Based on my interpretation/understanding of how meetings work, I updated the collaborative scratchpad with agenda notes for the next meeting related to an issue that fricklerhandwerk invited me to discuss.

Please feel free to correct it/move it, if I have misunderstood where it is supposed to land.

I am not yet sure if I will show up to the meeting, due to other issues.

22:50:18
@infinisil:matrix.orginfinisil bzm3r: Sounds good to me :) 22:53:19
21 Dec 2023
@danielsidhion:nixos.devdanielsidhionFollow up PR to my previous question: migration of the other examples in this chapter to the new example style. I could use some help figuring out how to migrate that last example in the chapter. Too many names and concepts super close to each other making it harder. https://github.com/NixOS/nixpkgs/pull/27579108:51:48
@bzzm3r:matrix.org@bzzm3r:matrix.orgdoes the meeting usually start a little late? 😅15:05:26
@danielsidhion:nixos.devdanielsidhionhttps://jitsi.lassul.us/nix-documentation This is the link15:06:28
@bzzm3r:matrix.org@bzzm3r:matrix.orgso this is the wrong link: https://meet.jit.si/nix-documentation!15:08:10
@bzzm3r:matrix.org@bzzm3r:matrix.org
In reply to @bzzm3r:matrix.org
so this is the wrong link: https://meet.jit.si/nix-documentation!
(this is in the readme)
15:08:22
@bzzm3r:matrix.org@bzzm3r:matrix.orgah wait, that is because I was looking at the wrong commit 😆15:12:37
22 Dec 2023
@danielsidhion:nixos.devdanielsidhionI just started on my quest to modernize all the examples in the manual with the new admonition syntax, and the first file I opened ended up having a bunch of outdated and unneeded information, so I decided to take a bit more time and figure out the history of the changes and document things better: https://github.com/NixOS/nixpkgs/pull/27602910:59:26
@danielsidhion:nixos.devdanielsidhionI hope not all files end up like this lol But the information on this one was pretty easy to understand by following a couple PR links and searching things on nixpkgs, so I ended up doing an almost full rewrite of the section. Apologies for the added scope.11:00:37
@danielsidhion:nixos.devdanielsidhion(as a bonus, all examples in the file are full working examples - if I see the opportunity, I might continue doing things this way to make it easier in the future if/when we decide to start testing all examples in the manuals to make sure they work)11:02:27
@infinisil:matrix.orginfinisil danielsidhion: This is great! 11:32:39
@danielsidhion:nixos.devdanielsidhion Also when going through this, I'm starting to create issues for extra work that is either more than I can do at the moment, or is stuff that I'd try to revisit at some point. It improves either the documentation or stuff in Nixpkgs, and I think it's the sort of thing bzm3r would love to have to work on issues with very specific scope. Here are two issues I opened from my rewrite of that section:
https://github.com/NixOS/nixpkgs/issues/276033
https://github.com/NixOS/nixpkgs/issues/276034
11:34:35
23 Dec 2023
@raitobezarius:matrix.orgraitobezarius changed their display name from raitobezarius to raitobezarius (DECT 2128).22:22:41
24 Dec 2023
@bzzm3r:matrix.org@bzzm3r:matrix.org
In reply to @danielsidhion:nixos.dev
Also when going through this, I'm starting to create issues for extra work that is either more than I can do at the moment, or is stuff that I'd try to revisit at some point. It improves either the documentation or stuff in Nixpkgs, and I think it's the sort of thing bzm3r would love to have to work on issues with very specific scope. Here are two issues I opened from my rewrite of that section:
https://github.com/NixOS/nixpkgs/issues/276033
https://github.com/NixOS/nixpkgs/issues/276034
danielsidhion: thank you! (I'm also very glad that you did decide to ping me re: looking into these issues)
08:26:58
@bzzm3r:matrix.org@bzzm3r:matrix.org(so please feel free to continue to ping me on such stuff, both here, and on GitHub)08:28:52
@bzzm3r:matrix.org@bzzm3r:matrix.org * (so please continue to ping me on such stuff, both here, and on GitHub)08:29:10
@jkxyz:matrix.org@jkxyz:matrix.org set a profile picture.18:12:55
25 Dec 2023
@julienmalka:matrix.orgJulien changed their display name from Julien to Julien - DECT 4575.20:03:43
26 Dec 2023
@danielsidhion:nixos.devdanielsidhionAlso had to change a bit of content on this one, but at a way smaller scale: https://github.com/NixOS/nixpkgs/pull/276821 When working on it, I realised the manual doesn't seem to follow a convention for shell commands and their outputs, and created the following issue to track this: https://github.com/NixOS/nixpkgs/issues/276829 I'll put this issue on the agenda for some meeting next year, but I'm hoping it won't take long to achieve consensus. Once we have one, I can add it to my list of "things to update while I go through every file of the nixpkgs manual".02:03:50
@matthewcroughan:defenestrate.itmatthewcroughan @fosdem changed their display name from matthewcroughan - nix.how to matthewcroughan - Linux 6.7 When.16:48:35

Show newer messages


Back to Room ListRoom Version: 6