| 15 Jun 2023 |
 pennae | colocating docs sounds a lot like rustdoc and if repl integration is wanted we should really get the docs syntax rfc done first, and then fold everything into nix itself | 18:48:26 |
| pennae | either way, ¬docbook first. then that's finally done :D | 19:26:46 |
| 16 Jun 2023 |
| pennae | should we just merge the dedocbooking pt 1 later or wait for roberth to review it too | 09:09:38 |
 Jan Tojnar | looks like nixos/doc/manual/man-pages.xml has been forgotten? | 12:36:32 |
| Jan Tojnar | but that was for one of the previous PR | 12:36:54 |
| Jan Tojnar | * but that was for one of the previous PRs | 12:36:56 |
 i97henka | Happy Friday all - https://vadimkravcenko.com/shorts/proper-documentation/
Not 100% applicable to what we do but still worth a read I think. | 13:28:05 |
 @brian:bmcgee.ie | I'm spending some time going through the open PR's in nix.dev. I'm starting with the dependabot PRs. It looks like I have the power to close issues, so I'm gonna close those I think are no longer relevant unless anyone objects? | 13:33:41 |
| @brian:bmcgee.ie | Like this for example: https://github.com/NixOS/nix.dev/pull/329 | 13:33:49 |
| @brian:bmcgee.ie | myst-parser in master is now 1.0.0 | 13:34:09 |
| @brian:bmcgee.ie | Managed to close a few and merged the cachix action change. The remainder are conflicts with the poetry lock file | 13:44:46 |
| @brian:bmcgee.ie | Gonna hunt for some other low hanging fruit | 13:45:04 |
| @brian:bmcgee.ie | There's some PR's like this one https://github.com/NixOS/nix.dev/pull/197 which still seem useful but I don't know how they fit into the latest docs thinking / recent work on learning journey etc | 13:53:34 |
| @brian:bmcgee.ie | Is there someone who should be a reviewer on PRs like this by default? | 13:54:10 |
| @brian:bmcgee.ie | Maybe a group PR review session for nix.dev at some point would help get through the backlog and ping people to resolve conflicts as necessary. I don't want to prod someone to resolve a conflict just for it to get rejected | 13:58:31 |
| pennae | In reply to @jtojnar:matrix.org
looks like nixos/doc/manual/man-pages.xml has been forgotten? oh, that should go away too | 17:24:29 |
 Sandro 🐧 | In reply to @brian:bmcgee.ie
There's some PR's like this one https://github.com/NixOS/nix.dev/pull/197 which still seem useful but I don't know how they fit into the latest docs thinking / recent work on learning journey etc we shouldn't recommend this. Debians version is, as usual, very out of date and maintenance is lacking | 21:17:56 |
| Sandro 🐧 | also they disable the sandbox by default which is completely unsupported on x86_64-linux and will cause issues https://salsa.debian.org/debian/nix/-/blob/master/debian/nix.install.files/nix.conf#L5 | 21:19:14 |
| Sandro 🐧 | and the PR is from volth so we have no clue what it was about | 21:19:41 |
| 18 Jun 2023 |
 adamcstephens | Maybe they’d be open to changing that setting? | 02:01:11 |
 asymmetric | https://mtlynch.io/notes/nix-first-impressions/ | 18:04:26 |
| asymmetric | Lists zero-to-nix as the best learning resource for beginners | 18:04:54 |
| asymmetric | We (official docs) are nowhere on that list 😢 (yet) | 18:05:24 |
| asymmetric | But they do mention this: https://nix.dev/tutorials/nixos/build-and-deploy/installing-nixos-on-a-raspberry-pi | 18:06:25 |
| asymmetric | 
Download ima_d29f93d.png | 18:07:47 |
| asymmetric | This seems to agree with the position that it’s not Nixlang that people struggle with, but the basic concepts | 18:08:28 |
| asymmetric | Maybe? | 18:08:58 |
 Dominic Mills | I agree with this view | 18:10:19 |
| Dominic Mills | For the longest time I couldn't understand what flakes were and what utility it's provided over using a nix shell. | 18:11:17 |
| Dominic Mills | Redacted or Malformed Event | 18:12:03 |
