| 9 Jan 2024 |
 asymmetric | Regarding this issue, in the event the documentation team were to receive some funds, I wonder how prepared we would be, in terms of distributing funds, both to people and to tasks. fricklerhandwerk you probably have experience here? Is there some document that it would make sense to take a look at before this call? | 09:19:19 |
 fricklerhandwerk | In reply to @asymmetric:matrix.dapp.org.uk
Regarding this issue, in the event the documentation team were to receive some funds, I wonder how prepared we would be, in terms of distributing funds, both to people and to tasks. fricklerhandwerk you probably have experience here? Is there some document that it would make sense to take a look at before this call? As always when getting money, there needs to be some setting goals and coordination. There is also Google Season of Docs coming up again, and preparing a project for applying would be good. We have some preliminary work back from the STF application in June that could be built upon. | 11:39:55 |
 @jade_:matrix.org | https://github.com/NixOS/nixpkgs/pull/252091 is now rebased and ready to review | 13:48:58 |
| 10 Jan 2024 |
|  @philipp:xndr.de changed their display name from philipp to philipp (prolog in linux kernel, when). | 13:47:04 |
| @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 |
