!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

415 Members
Discussion about documentation improvements around the Nix ecosystem84 Servers

Load older messages


SenderMessageTime
18 Dec 2023
@bzzm3r:matrix.org@bzzm3r:matrix.org Some things are confusing. For instance, this is marked no status, but has a draft PR in play. 10:06:15
@bzzm3r:matrix.org@bzzm3r:matrix.org Also, this and this ought to be on the project board. 10:10:58
@bzzm3r:matrix.org@bzzm3r:matrix.orgIs the project board meant to be used, or was it just an experiment that has fallen out of favour?10:11:46
@bzzm3r:matrix.org@bzzm3r:matrix.orgOh, I just ran into this today: https://github.com/NixOS/nix/issues/798110:20:05
@bzzm3r:matrix.org@bzzm3r:matrix.orgSo, that's something I definitely can do. 10:20:21
@bzzm3r:matrix.org@bzzm3r:matrix.orgOr...should I just re-write the nix-build CLI? 🤔10:20:46
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @bzzm3r:matrix.org
Oh, I just ran into this today: https://github.com/NixOS/nix/issues/7981
That's a good one, it should be fairly limited in scope.
12:12:35
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @bzzm3r:matrix.org
Or...should I just re-write the nix-build CLI? 🤔
Please don't do that to yourself
12:13:03
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @bzzm3r:matrix.org
Is the project board meant to be used, or was it just an experiment that has fallen out of favour?

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.

12:16:54
@fricklerhandwerk:matrix.orgfricklerhandwerkOne 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 getting over the finish line.12:24:50
@fricklerhandwerk:matrix.orgfricklerhandwerk * 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.12:25:09
@fricklerhandwerk:matrix.orgfricklerhandwerkAnd then aggressively push to finish whatever was started and is still in active progress...12:26:38
@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

Show newer messages


Back to Room ListRoom Version: 6