!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

421 Members
Discussion about documentation improvements around the Nix ecosystem87 Servers

Load older messages


SenderMessageTime
18 Dec 2023
@bzzm3r:matrix.org@bzzm3r:matrix.org
In reply to @fricklerhandwerk:matrix.org
One practical problem I've observed in the Nix maintainer team, where we have a very formalised meeting structure and in fact curate the board very nicely, is that the process nudges us to delegate tasks we don't actually have time to follow through with. So the tail end of the pipeline is broken due to limited capacity and the challenges to estimate workload. The front end works fairly well though, because we do triaging to determine whether something fits current priorities and direction, or make design decisions to help produce sustainable solutions. Some contributors follow up, many don't, due to lack of time to actually finish tasks that very often blow up in size once you take a close look at them.

We have the exact same problem in documentation, except we stopped assigning tasks as we were all fully booked at some point. And since contributions tend to be either very small or very large, triaging doesn't seem to serve much of a purpose. We should probably try to find some middle ground, to really get an up-to-date grasp on who's currently working on what, how complex a given task is (and which rabbit holes it uncovers), which resources are available to finish it, etc. -- simply to know what to focus the effort on to get it over the finish line.
could a relatively simple solution be using tags which assign priorities as guesses (we can't know the true priority)?
18:39:46
@bzzm3r:matrix.org@bzzm3r:matrix.org
In reply to @fricklerhandwerk:matrix.org
One practical problem I've observed in the Nix maintainer team, where we have a very formalised meeting structure and in fact curate the board very nicely, is that the process nudges us to delegate tasks we don't actually have time to follow through with. So the tail end of the pipeline is broken due to limited capacity and the challenges to estimate workload. The front end works fairly well though, because we do triaging to determine whether something fits current priorities and direction, or make design decisions to help produce sustainable solutions. Some contributors follow up, many don't, due to lack of time to actually finish tasks that very often blow up in size once you take a close look at them.

We have the exact same problem in documentation, except we stopped assigning tasks as we were all fully booked at some point. And since contributions tend to be either very small or very large, triaging doesn't seem to serve much of a purpose. We should probably try to find some middle ground, to really get an up-to-date grasp on who's currently working on what, how complex a given task is (and which rabbit holes it uncovers), which resources are available to finish it, etc. -- simply to know what to focus the effort on to get it over the finish line.
* could a relatively simple solution be using github tags which assign priorities as guesses (we can't know the true priority)?
18:39:55
@bzzm3r:matrix.org@bzzm3r:matrix.orgI often see the "hit 👍️ to mark as a priority"18:40:16
@bzzm3r:matrix.org@bzzm3r:matrix.orgbut...no one's actually hitting that 🫠18:40:32
@bzzm3r:matrix.org@bzzm3r:matrix.org
In reply to @fricklerhandwerk:matrix.org

It is meant to be used, but given the very limited amount of time we have, we usually prioritise group reviews to get things merged that have happened in between meetings.

We should probably have a formalised meeting agenda that gives the board a couple of minutes of attention.

Yes, I think this would be helpful. Especially as we do encourage people to make issues
18:43:36
@bzzm3r:matrix.org@bzzm3r:matrix.orga lot happens through the weekly meeting 😮‍💨 which is only fair18:44:39
19 Dec 2023
@jade_:matrix.org@jade_:matrix.org
In reply to @bzzm3r:matrix.org
Or...should I just re-write the nix-build CLI? 🤔
you know you can nix build -f . someAttr on non flakes yeah?
00:04:04
@bzzm3r:matrix.org@bzzm3r:matrix.org
In reply to @jade_:matrix.org
you know you can nix build -f . someAttr on non flakes yeah?
Yeah, I just don't like the nix3 cli.
03:15:47
@qyriad:matrix.org@qyriad:matrix.orgusability or personal?03:35:33
@asymmetric:matrix.dapp.org.ukasymmetric

does anyone know how to run the individual phases in the nix.dev repo?

i tried:

nix-shell default.nix -A build
$ buildPhase

but it doesn't work, and type buildPhase gives me the generic phase rather than the one defined in default.nix

13:56:14
@infinisil:matrix.orginfinisil asymmetric: phases=buildPhase genericBuild should work 14:22:18
@infinisil:matrix.orginfinisil asymmetric: See also https://nixos.org/manual/nixpkgs/stable/#sec-building-stdenv-package-in-nix-shell 14:22:45
@infinisil:matrix.orginfinisilAh I see you also commented in https://discourse.nixos.org/t/nix-build-phases-run-nix-build-phases-interactively/36090, which I also wanted to link :)14:23:46
@asymmetric:matrix.dapp.org.ukasymmetric 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 15:57:28
@asymmetric:matrix.dapp.org.ukasymmetric * 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 15:57:48
@asymmetric:matrix.dapp.org.ukasymmetric * 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 15:58:26
@asymmetric:matrix.dapp.org.ukasymmetricredirect.png
Download redirect.png
15:59:20
@asymmetric:matrix.dapp.org.ukasymmetric oic, it needs an extrension, /package-management/basic-package-management.html 16:02:13
@asymmetric:matrix.dapp.org.ukasymmetric it's a bit confusing, since the web server won't provide the redirect without the .html, but the netlify syntax doesn't require one 16:03:26
@asymmetric:matrix.dapp.org.ukasymmetric * it's a bit confusing, since the redirect won't work without the .html, but the netlify syntax doesn't require one 16:05:46
@asymmetric:matrix.dapp.org.ukasymmetric So basically, a url like https://nixos.org/manual/nix/stable/package-management/basic-package-mgmt will not redirect correctly, it has to have a .html at the end. is this known behavior? Or are there urls like this one that are now link-rotting? 16:20:42
@asymmetric:matrix.dapp.org.ukasymmetricin general, URLs don't need an extension on nixos.org, e.g. both https://nixos.org/manual/nix/stable/command-ref/nix-env.html and https://nixos.org/manual/nix/stable/command-ref/nix-env work16:21:34
@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

Show newer messages


Back to Room ListRoom Version: 6