| 18 Dec 2023 |
 @bzzm3r:matrix.org | In reply to @olafklingt:matrix.org
I think most of the noise is not intentional. The difficult part of improving the documentation is not to add content but to make it more concise. So i basically agree with your observations. * Just to be clear, I'm not talking about the intentional obfuscation being due to the nix documentaiton devs. | 09:27:58 |
| @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) | 09:29:47 |
| @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 | 09:31:18 |
 @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 | 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 | (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 | Some things are confusing. For instance, this is marked no status, but has a draft PR in play. | 10:06:15 |
| @bzzm3r:matrix.org | Also, this and this ought to be on the project board. | 10:10:58 |
| @bzzm3r:matrix.org | Is 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 | Oh, I just ran into this today: https://github.com/NixOS/nix/issues/7981 | 10:20:05 |
| @bzzm3r:matrix.org | So, that's something I definitely can do. | 10:20:21 |
| @bzzm3r:matrix.org | Or...should I just re-write the nix-build CLI? 🤔 | 10:20:46 |
 fricklerhandwerk | 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 |
