!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

398 Members
Discussion about documentation improvements around the Nix ecosystem81 Servers

Load older messages


SenderMessageTime
23 Jan 2022
@jonringer:matrix.orgjonringer So, the headers allow for us to drop a bunch of "The options <foo> <bar> ..." "The package pkgs.<pkgname>" prose 19:57:24
@jonringer:matrix.orgjonringer * Also, the headers allow for us to drop a bunch of "The options <foo> <bar> ..." "The package pkgs.<pkgname>" prose 19:57:49
@jonringer:matrix.orgjonringerhttps://github.com/NixOS/nixpkgs/pull/15635520:14:17
29 Jan 2022
@tpankrath:matrix.orgTobias Pankrath joined the room.09:16:00
@joepie91:pixie.townjoepie91 🏳️‍🌈cheatsheet.png
Download cheatsheet.png
22:57:28
@joepie91:pixie.townjoepie91 🏳️‍🌈I've finished my 'cheatsheet', I think22:57:35
@joepie91:pixie.townjoepie91 🏳️‍🌈would appreciate any fresh eyes to look through it and see if I got anything wrong :)22:57:45
@joepie91:pixie.townjoepie91 🏳️‍🌈mainly regarding function signatures and such22:57:57
@joepie91:pixie.townjoepie91 🏳️‍🌈I can probably also export a HTML version if that's preferred22:58:39
@joepie91:pixie.townjoepie91 🏳️‍🌈yeah... readability of that kinda sucks, lol22:59:17
@joepie91:pixie.townjoepie91 🏳️‍🌈Download nix-cheatsheet-222:59:21
@joepie91:pixie.townjoepie91 🏳️‍🌈but there we go :p22:59:24
@joepie91:pixie.townjoepie91 🏳️‍🌈but yeah, review very much appreciated, I want to post this publicly soon-ish but I want to make sure there's no nonsense in there23:02:41
@joepie91:pixie.townjoepie91 🏳️‍🌈I'll probably extend it with builders and such at some later time23:03:43
@jtojnar:matrix.orgJan Tojnarfor flip, you mention two argument functions but there is technically no such thing23:39:50
@jtojnar:matrix.orgJan Tojnarmaybe introduce currying?23:40:11
@jtojnar:matrix.orgJan Tojnar perhaps you want to add arguments to partition, callBy, … predicates to make it obvious they are functions 23:48:03
@jtojnar:matrix.orgJan Tojnar * perhaps you want to add arguments to partition, groupBy, … predicates to make it obvious they are functions 23:48:21
@jtojnar:matrix.orgJan Tojnar you might also want to mention the full <set>.<attr> or <fallback> syntax 23:51:49
@jtojnar:matrix.orgJan Tojnarstring concatenation has wrong operator23:59:03
30 Jan 2022
@joepie91:pixie.townjoepie91 🏳️‍🌈
In reply to @jtojnar:matrix.org
perhaps you want to add arguments to partition, groupBy, … predicates to make it obvious they are functions
whoops, oversight, those were supposed to have arguments. fixed, thanks
00:01:30
@joepie91:pixie.townjoepie91 🏳️‍🌈
In reply to @jtojnar:matrix.org
string concatenation has wrong operator
fixed
00:01:37
@joepie91:pixie.townjoepie91 🏳️‍🌈
In reply to @jtojnar:matrix.org
you might also want to mention the full <set>.<attr> or <fallback> syntax
good point, will add that as well
00:01:47
@joepie91:pixie.townjoepie91 🏳️‍🌈
In reply to @jtojnar:matrix.org
for flip, you mention two argument functions but there is technically no such thing
I'm forgoing technical correctness in favour of accessibility, deliberately :)
00:02:00
@joepie91:pixie.townjoepie91 🏳️‍🌈(aside, the manual itself actually speaks of multiple arguments in a couple of places)00:03:20
@joepie91:pixie.townjoepie91 🏳️‍🌈but yeah, the target demographic is "people without an FP background", and the scope is "enough information to find your way to the right utility for your usecase, and avoid particularly bad footguns, but no more than that"00:04:57
@joepie91:pixie.townjoepie91 🏳️‍🌈for the semantic details, of which there are many, the manual is the correct place to look :p00:05:21
@joepie91:pixie.townjoepie91 🏳️‍🌈same reason I generally don't specify return values for example00:05:57
@jtojnar:matrix.orgJan Tojnar I believe path should always be preferred to filterSource nowadays 00:06:19
@joepie91:pixie.townjoepie91 🏳️‍🌈wasn00:06:42

There are no newer messages yet.


Back to Room ListRoom Version: 6