| 10 Jan 2024 |
|  @philipp:xndr.de changed their display name from philipp (prolog in linux kernel, when) to philipp (prolog in linux kernel when). | 13:47:14 |
| @philipp:xndr.de changed their display name from philipp (prolog in linux kernel when) to test. | 13:47:50 |
| @philipp:xndr.de changed their display name from test to philipp. | 13:49:29 |
|  @viper.:matrix.org left the room. | 15:39:51 |
 @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
| 17:43:11 |
| @9999years:matrix.org |
And I don't mind reading 'code as docs' in general but it's pretty much required here.
this sentiment remains, even from people enthusiastic about nix...
https://news.ycombinator.com/item?id=38931306
| 17:52:03 |
| 11 Jan 2024 |
 @bzzm3r: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
no. | 20:15:48 |
 Chris McDonough | "no"? | 20:23:26 |
| @bzzm3r:matrix.org | In reply to @mcdonc:matrix.org
"no"? precisely. | 20:24:37 |
| Chris McDonough | speechless | 20:25:15 |
| @bzzm3r:matrix.org | In reply to @mcdonc:matrix.org
speechless It was a short, low content message, and it's not clear what the point of it was.
The simplest way to respond to it that wasn't "this is incorrect because....", is to disagree with a "no".
| 20:26:12 |
| @bzzm3r:matrix.org | But it is extremely off-bse. | 20:26:24 |
| @bzzm3r:matrix.org | * But it is extremely off-base. | 20:26:32 |
| Chris McDonough | 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 | 20:27:11 |
| Chris McDonough | there is no upside afaict | 20:27:43 |
| @bzzm3r: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 Yeah, understandable. If you don't have the motivation or energy, you shouldn't force yourself. | 20:28:00 |
| Chris McDonough | alrighty then | 20:28:06 |
| @bzzm3r:matrix.org | In reply to @mcdonc:matrix.org
alrighty then A little more carefully however, if I am understanding the subtext of your message properly:
-
if my comment is what is making you "lay down a threat", then consider that I am not a member of the Nix documentation team. You should base such decisions off of your interactions with the team leader (fricklerhandwerk) and their deputies (e.g. infinisil)
-
if you believe my message is "rude", you should consider whether or not the person I was responding to (who was not you, as far as I know), has bothered scrolling up to read some of the discussion in this channel.
But to be honest, it's very difficult to figure out your chain of comments.
| 20:33:40 |
 asymmetric | 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 please don't get discouraged, we appreciate your contributions (all contributions in fact) | 20:41:09 |
| asymmetric | (spekaking for myself: i've been super busy and haven't had time to review your documentation pr) | 20:41:47 |
| 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 |
