!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

398 Members
Discussion about documentation improvements around the Nix ecosystem88 Servers

Load older messages


SenderMessageTime
30 Jan 2022
@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
@joepie91:pixie.townjoepie91 🏳️‍🌈oops00:16:48
@joepie91:pixie.townjoepie91 🏳️‍🌈fixed00:17:04
@jtojnar:matrix.orgJan Tojnar there is also pkgs.nix-gitignore if you want to avoid flakes https://nixos.org/manual/nixpkgs/stable/#sec-pkgs-nix-gitignore 00:21:20
@joepie91:pixie.townjoepie91 🏳️‍🌈ah, handy00:22:39
@joepie91:pixie.townjoepie91 🏳️‍🌈will have a look at that later00:22:49
@jtojnar:matrix.orgJan Tojnar but the functions I had in mind and actually used are lib.sources.cleanSource & co. 00:23:05
@jtojnar:matrix.orgJan Tojnar which are based on builtins.path 00:23:13
@joepie91:pixie.townjoepie91 🏳️‍🌈are those documented?00:23:21

Show newer messages


Back to Room ListRoom Version: 6