!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

436 Members
Discussion about documentation improvements around the Nix ecosystem93 Servers

Load older messages


SenderMessageTime
1 Sep 2023
@penguincoder:matrix.wolfie.pw@penguincoder:matrix.wolfie.pwmaybe instead of putting it directly in nix.dev we could make an "awesome nix reading" repo instead? that could be more independent, include commercial software without any implication of promotion, and all kinds of FOSS sources too.14:21:04
@fricklerhandwerk:matrix.orgfricklerhandwerkThere already exists https://github.com/nix-community/awesome-nix and the problem I personally have with it is that it's not helping to guide if there is just a huge collection of things all you know about is the name. And that's our biggest problem: getting the big picture and essential skills to be able to navigate the ecosystem and problem space yourself14:51:23
@fricklerhandwerk:matrix.orgfricklerhandwerk * There already exists https://github.com/nix-community/awesome-nix and the problem I personally have with it (or any "awesome" resource) is that it's not helping to guide if there is just a huge collection of things all you know about is the name. And that's our biggest problem: getting the big picture and essential skills to be able to navigate the ecosystem and problem space yourself14:51:39
@fricklerhandwerk:matrix.orgfricklerhandwerk * There already exists https://github.com/nix-community/awesome-nix and the problem I personally have with it (or any "awesome" resource) is that it's not helping to guide beginners if there is just a huge collection of things all you know about is the name. And that's our biggest problem: getting the big picture and essential skills to be able to navigate the ecosystem and problem space yourself14:51:51
@penguincoder:matrix.wolfie.pw@penguincoder:matrix.wolfie.pwThen the problem should become a tree-like shape. Start at the very beginning, then make a bunch of choices (IOW pick a tool), and go down a bunch of paths to show how you might navigate the solutions. For instance, after getting nix installed, you could make a flake tutorial, then use flake-parts down one path, and flake-utils down another... then show how you might make derivations after that using each system.15:02:55
@penguincoder:matrix.wolfie.pw@penguincoder:matrix.wolfie.pw As a beginner myself, it would be helpful to have those kinds of paths written down so that I can see the choices that are made and get a better handle on why as well as what. 15:06:40
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @penguincoder:matrix.wolfie.pw
Then the problem should become a tree-like shape. Start at the very beginning, then make a bunch of choices (IOW pick a tool), and go down a bunch of paths to show how you might navigate the solutions. For instance, after getting nix installed, you could make a flake tutorial, then use flake-parts down one path, and flake-utils down another... then show how you might make derivations after that using each system.
Yes, that is exactly what this PR is trying to address: https://github.com/NixOS/nix.dev/pull/701
15:41:58
2 Sep 2023
@zmitchell:matrix.org@zmitchell:matrix.org proofconstruction: I was going to post the working group meeting notes today. I'm working on the This Month in Nix Docs post now, please don't post that too. 00:02:41
@zmitchell:matrix.org@zmitchell:matrix.orghttps://discourse.nixos.org/t/this-month-in-nix-docs-4-july-august-2023/3250200:28:52
@infinisil:matrix.orginfinisil zmitchell: Hmm you didn't reuse the previous start of the update: https://pad.lassul.us/BQletwJYRkWAVZ9HY76kGA 00:37:21
@infinisil:matrix.orginfinisilAnd the Nixpkgs PR list seems rather poor, we curated that in the above pad00:37:35
@infinisil:matrix.orginfinisilIn particular https://github.com/NixOS/nixpkgs/pull/245243 seems to be missing, which we put as a highlight in the pad00:37:52
@infinisil:matrix.orginfinisil * And the Nixpkgs PR list seems rather poor (has various package updates), we curated that in the above pad00:38:25
@infinisil:matrix.orginfinisil(actually, seems to be written about, but not linked to!)00:42:22
@proofconstruction:matrix.orgproofconstructionApologies, I just realized nothing got posted from yesterday and dumped the notes to discourse before going out for a walk. I can still edit the post if you have additions.02:47:18
@zmitchell:matrix.org@zmitchell:matrix.org I took all of the bullets from the highlights section and wrote about them. The only one I didn’t write about was the code examples test because it hasn’t been merged yet, and, as discussed on Thursday, will take quite some time before it gets there. 18:37:24
@zmitchell:matrix.org@zmitchell:matrix.orgAnd the extra PRs look like they're because of the additional tag that was added to the script that scrapes GitHub18:43:34
@zmitchell:matrix.org@zmitchell:matrix.orgI think it was a good idea to include that tag (I'd rather not miss something), but I can actually curate the PR list next time. Generally I'm not sure people care all that much :)18:44:55
3 Sep 2023
@infinisil:matrix.orginfinisil zmitchell: Still, the link to the clean up contributing docs PR is missing 14:54:04
@zmitchell:matrix.org@zmitchell:matrix.org I added a comment with the link 16:40:27
4 Sep 2023
@nord:one.ems.hostNORD left the room.04:05:11
@fricklerhandwerk:matrix.orgfricklerhandwerkI’m in the process of joining the meeting but there is some weird authentication issue14:03:29
@proofconstruction:matrix.orgproofconstructionAh right, they changed things to require login now14:05:10
@fricklerhandwerk:matrix.orgfricklerhandwerkYeah and that fails with an error message14:05:53
@fricklerhandwerk:matrix.orgfricklerhandwerkSigh…14:07:18
@proofconstruction:matrix.orgproofconstructionI actually can't even find the auth mechanism14:09:27
@proofconstruction:matrix.orgproofconstructionOK found it but now it just hangs trying to hand off to the client14:11:09
@proofconstruction:matrix.orgproofconstructionAh there's the error. Looks like we need a new solution already.14:11:54
jitsi widget added by @fricklerhandwerk:matrix.orgfricklerhandwerk14:12:33
@fricklerhandwerk:matrix.orgfricklerhandwerkLet's try Matrix here14:13:12

Show newer messages


Back to Room ListRoom Version: 6