| 11 Jan 2024 |
 asymmetric | * (speaking for myself: i've been super busy and haven't had time to review your documentation pr) | 20:42:25 |
 Chris McDonough | i appreciate it it asymmetric , i have maintained projects and i understand | 20:42:31 |
| Chris McDonough | but i will say that my "onboarding" has been pretty unpleasant so far... it's not your fault of course... but man | 20:43:10 |
| asymmetric | In reply to @mcdonc:matrix.org
but i will say that my "onboarding" has been pretty unpleasant so far... it's not your fault of course... but man feel free to share what hasn't worked, i'm sure we can learn from it. either here or in private if you prefer | 20:44:04 |
| asymmetric | In reply to @mcdonc:matrix.org
but i will say that my "onboarding" has been pretty unpleasant so far... it's not your fault of course... but man * feel free to share what your experience has been like, i'm sure we can learn from it. either here or in private if you prefer | 20:44:22 |
 @bzzm3r:matrix.org | In reply to @mcdonc:matrix.org
but i will say that my "onboarding" has been pretty unpleasant so far... it's not your fault of course... but man Would you like to speak a bit more about why it has been unpleasant? That might be helpful. I think more than any other team I have encountered on Nix this is one of the friendliest. | 20:44:41 |
| @bzzm3r:matrix.org | I would like it if you could include me in the conversation with asymmetric. | 20:46:01 |
| @bzzm3r:matrix.org | * I would like it if you could include me in the conversation with asymmetric. But this is a request, not a demand. | 20:46:30 |
| 12 Jan 2024 |
 @9999years:matrix.org | In reply to @bzzm3r:matrix.org
no. should we not value user feedback from people who found the docs so alienating they left nix entirely? this dismissive and condescending approach to anyone who points out deficiencies with the nix ecosystem is exactly why so many people view nix as fundamentally insular and user-hostile | 00:20:48 |
| @9999years:matrix.org | In reply to @mcdonc:matrix.org
you know, i submitted a pr a while back to the nixpkgs docs... and i attended a docs meeting in jitsi... and i volunteered to help.. but i'm starting to have second thoughts i've heard this one before ... every time someone explains that they've been driven out of the nix community due to perceived hostility there's a lot of "we're here to listen and learn" but nothing ever seems to change | 00:31:56 |
 @qyriad:matrix.org | In reply to @9999years:matrix.org
I read the entire nix docs but I think it's the kind of documentation that's only useful if you already kind of get what's going on. It feels like you have to gather the knowledge from various random blogs. Last time I checked there surprisingly was not a single book which covers nix. I feel like a comprehensive book which teaches nix from the ground up and explains all the different ways of using nix would really help me and I would purchase such a book without hesitation if it existed.
still lots of work to do with the nix docs
https://news.ycombinator.com/item?id=38930947
Last time I checked there surprisingly was not a single book which covers nix. I feel like a comprehensive book which teaches nix from the ground up and explains all the different ways of using nix would really help me and I would purchase such a book without hesitation if it existed.
There really does need to be a document you can read cover to cover to understand the Nix ecosystem. Nix itself, Nixpkgs, and NixOS modules can't really be understood independently in any kind of useful way. Obviously it can't cover the entire API surface of Nixpkgs, but programming books don't cover the entire API surface of the standard library either — but they should teach you enough to be able to read std docs and — critically — read and understand source code in the ecosystem!
| 00:48:01 |
| @qyriad:matrix.org | In reply to @asymmetric:matrix.dapp.org.uk
feel free to share what your experience has been like, i'm sure we can learn from it. either here or in private if you prefer I can't speak for Chris McDonough, but I can't imagine this conversation inspires much faith in this Nix community's friendliness. | 00:52:11 |
