Nix Documentation | 418 Members | |
| Discussion about documentation improvements around the Nix ecosystem | 86 Servers |
| Sender | Message | Time |
|---|---|---|
| 20 Nov 2023 | ||
In reply to @proofconstruction:matrix.org I very much agree with you on this too. 100%. I think what is special about Nix currently isn't its present day manifestation, but rather the fact that it exists at all, and even in this "sharp-edged" (broken) form, it is a proof of concept of how things could be, if we didn't take an ad hoc, cowboy attitude to everything. (So it always surprises me that Nix-lang has the shape it does, especially given the intellectual culture it is a product of....) When you mentioned this, I think I realized an implicit assumption I had made (and I am not sure why I made this, in hindsight!): that flakes/ So yeah, overall, I do think we are in strong alignment. | 16:56:03 | |
Does the "search button" on nix.dev work for you all too? (It currently does not for me (NixOS + Firefox + Privacy Badger + uBlockOrigin + Decentraleyes) | 17:26:57 | |
also, a lot of the "good first issues" deal with Sphinx issues...would it be too idealistic (definitely not a "good first issue" at the very least) if we just ported nix.dev to something a bit nicer (e.g. Svelte + TypeScript would be nice) | 17:28:45 | |
| but I doubt a docs framework exists for that, so yeah, not sure. | 17:29:17 | |
| Search works for me in NixOS + Firefox + uBlockOrigin :) | 17:38:32 | |
| * bzm3r: Search works for me in NixOS + Firefox + uBlockOrigin :) | 17:38:42 | |
| works for me with NixOS, Firefox & Privacy badger. | 17:39:42 | |
| henrik-ch: Did you perhaps already complete a walk through the tutorial? | 17:40:11 | |
| * works for me with NixOS, Firefox & Privacy badger. (api.github.com is orange when clicking the privacy badger icon) | 17:40:12 | |
| 20:18:00 | ||
In reply to @infinisil:matrix.orgReview posted, it's slightly funny as you have revised slightly since I started the review, but hopefully still something usable. I will check with you tomorrow to see if it's a good point to rereview. | 21:57:22 | |
In reply to @infinisil:matrix.org* Review posted, it's slightly funny as you have revised some parts since I started the review, but hopefully still something usable. I will check with you tomorrow to see if it's a good point to rereview. | 21:58:04 | |
| henrik-ch: Awesome thanks! No worries, I only appended, I didn't change anything existing :) | 21:58:37 | |
| By the way, it took me about 40 minutes from start to finish 😆 but that probably says more about my nix skills, and I preferred writing off the examples rather than copy the code from nix.dev for increased learning. | 22:03:46 | |
| henrik-ch: Ah nice, I think that makes this a pretty good size then! Though I also added a bunch of content afterwards :P | 22:07:29 | |
| I will remove some sections though after Valentin's feedback | 22:07:59 | |
| 21 Nov 2023 | ||
| Updated https://github.com/NixOS/nix.dev/pull/802, looking pretty good now imo :) | 02:40:41 | |
| * Updated https://github.com/NixOS/nix.dev/pull/802 and marked as ready for review, looking pretty good now imo :) | 02:40:52 | |
| 15:27:59 | ||
| 16:37:09 | ||
| fricklerhandwerk: Unless the github deployments thing is necessary for netlify (I don't think it is?), please turn it off (which needs repo admin permissions afaik), it's spamming events for every PR update: https://github.com/NixOS/nix.dev/pull/802 | 18:26:02 | |
In reply to @infinisil:matrix.orgi think it comes from here: https://github.com/NixOS/nix.dev/blob/master/.github/workflows/build-and-deploy.yml | 18:38:55 | |
the action has an enable-github-deployment option which defaults to true. we could make it dependent on whether the push is to master instead | 18:39:46 | |
* the netlify action has an enable-github-deployment option which defaults to true. we could make it dependent on whether the push is to master instead | 18:40:01 | |
| asymmetric: Ah I see, but what's the point of these github deployments anyways? The comment it posts in the PR always contains an up-to-date link to the netlify deployment | 18:41:22 | |
| * asymmetric: Ah I see, but what's the point of these github deployments anyways? The comment it posts in the PR always contains an up-to-date link to the netlify deployment: https://github.com/NixOS/nix.dev/pull/802#issuecomment-1817733137 | 18:41:35 | |
| don't think there's any special utility tbh.. other than getting a view of all deployments, and a summary in the project's sidebar | 18:43:59 | |
| asymmetric: https://github.com/NixOS/nix.dev/pull/803 | 18:54:03 | |