!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

431 Members
Discussion about documentation improvements around the Nix ecosystem89 Servers

Load older messages


SenderMessageTime
18 Dec 2023
@bzzm3r:matrix.org@bzzm3r:matrix.orgBut there is enough of an effort to delegitimize the current official docs (because they do not cover flakes, and because they refer to flakes as experimental features), that most newcomers (myself included) 09:29:47
@bzzm3r:matrix.org@bzzm3r:matrix.org * But there is enough of an effort to delegitimize the current official docs (because they do not cover flakes, and because they refer to flakes as experimental features), that most newcomers (myself included) did not realize that flakes were entirely optional instead, we saw the docs as entirely outdated09:31:18
@olafklingt:matrix.org@olafklingt:matrix.org
In reply to @bzzm3r:matrix.org

But there is enough of an effort to delegitimize the current official docs (because they do not cover flakes, and because they refer to flakes as experimental features), that most newcomers (myself included) did not realize that flakes were entirely optional

instead, we saw the docs as entirely outdated

I for myself decided to see it this not worth to deal with. It is something one has to live with in a world with multiple opinions and unequal distribution of power.

Obviously it's unfortunate.

09:49:52
@bzzm3r:matrix.org@bzzm3r:matrix.org
In reply to @fricklerhandwerk:matrix.org
And the reason we're circling around these issues are embedded in bzm3r's long introduction that started this exchange: as a group of developers working on the ecosystem, we lack focus and direction, and this is in part because there are so many rabbit holes. There are more problems to solve than hours available, and each of them is large enough to get frustrated and switch to something else. Therefore everything is notoriously unfinished.

Suppose you were to put on an imaginary despot's hat. Where would you direct efforts?

Would it still be on documentation?

If yes, then in that case, I found this recently: https://github.com/orgs/NixOS/projects/15/views/1

How can I find someone willing to prioritize tasks for me by assigning them to me? Could you do so?

09:50:44
@bzzm3r:matrix.org@bzzm3r:matrix.org(I can make decisions based on my own sensibilities, of course, and am willing to do so if that is preferred.)10:00:07
@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

Show newer messages


Back to Room ListRoom Version: 6