!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

435 Members
Discussion about documentation improvements around the Nix ecosystem92 Servers

Load older messages


SenderMessageTime
29 Jan 2022
@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
@joepie91:pixie.townjoepie91 🏳️‍🌈 * wasn't deprecated according to the manual, at least00:06:47
@joepie91:pixie.townjoepie91 🏳️‍🌈it does have a caveat on what it is and isn't suitable for00:07:23
@jtojnar:matrix.orgJan Tojnaryeah, one probably would want to use the lib wrappers around it anyway00:08:27
@jtojnar:matrix.orgJan Tojnaror something like https://github.com/numtide/nix-filter00:08:38
@joepie91:pixie.townjoepie91 🏳️‍🌈once flakes stabilize, I will probably update the cheatsheet to include such single-responsibility libraries00:09:21
@jtojnar:matrix.orgJan Tojnar typo in dirOf: director 00:10:02
@joepie91:pixie.townjoepie91 🏳️‍🌈whoops :D00:10:24

Show newer messages


Back to Room ListRoom Version: 6