!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

438 Members
Discussion about documentation improvements around the Nix ecosystem93 Servers

Load older messages


SenderMessageTime
29 Jan 2022
@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
@jtojnar:matrix.orgJan Tojnar I would probably list stdenv.mkDerivation first 00:13:00
@jtojnar:matrix.orgJan Tojnarif list the builtin at all00:13:13
@jtojnar:matrix.orgJan TojnarI have already seen some beginners confused by it00:13:33
@jtojnar:matrix.orgJan Tojnarsimilarly the fetching section – people will want nixpkgs fetchers 99 % of the time00:14:17
@jtojnar:matrix.orgJan Tojnar * similarly the fetching section – people will want nixpkgs fetchers 90 % of the time00:14:35
@joepie91:pixie.townjoepie91 🏳️‍🌈the nixpkgs fetchers! I knew I was forgetting something00:14:57
@joepie91:pixie.townjoepie91 🏳️‍🌈swapped around the derivation functions and added a note to only use the builtin if nixpkgs is not available00:15:21
@joepie91:pixie.townjoepie91 🏳️‍🌈will add the nixpkgs fetchers at some later time :p00:15:42
@joepie91:pixie.townjoepie91 🏳️‍🌈I've left a FIXME in my sheet00:15:49
@jtojnar:matrix.orgJan Tojnar DocBook is spelt with capital B e.g. in literalDocBook 00:16:19

Show newer messages


Back to Room ListRoom Version: 6