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

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

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

In reply to @mcdonc:matrix.org
"no"?

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".

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

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.

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

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

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

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

In reply to @bzzm3r:matrix.org
no.

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

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!