Nix Documentation | 398 Members | |
| Discussion about documentation improvements around the Nix ecosystem | 79 Servers |
| Sender | Message | Time |
|---|---|---|
| 10 Jul 2024 | ||
In reply to @proofconstruction:matrix.orgIt never fails to surprise me how time flies. This comment is also an attempt to understand how badly I'll spam the main channel when I comment in this thread... | 21:34:57 | |
| Download nix-docs-proposal.md | 21:37:41 | |
In reply to @enn_:matrix.orgclearly in no particular rush from my side 😅 I've attached a brief proposal relating to nix docs for consideration. Am happy to come along to an office hours session if that is useful / appropriate, or just receive feedback here, whatever works 🙂 | 21:39:27 | |
| 23:02:34 | ||
| 11 Jul 2024 | ||
| 10:53:04 | ||
| 17:11:22 | ||
| 15 Jul 2024 | ||
| I was trying to try to help out in the nix.dev repo by going through old issues and seeing if any can be closed or easily fixed. Should I ping someone from the issue if I think it can be closed or just leave a comment or something? | 00:23:44 | |
| Redacted or Malformed Event | 01:38:24 | |
| * I was thinking to try to help out in the nix.dev repo by going through old issues and seeing if any can be closed or easily fixed. Should I ping someone from the issue if I think it can be closed or just leave a comment or something? | 02:14:13 | |
| Download issues.md | 05:58:11 | |
| I commented on some issues. Here's a list of what I went through: | 05:58:14 | |
In reply to @willbush:matrix.orgHey, thanks for taking the tour! This stuff is very helpful. It’s best to comment on the issue though. Everyone can see it there and follow up. And for me personally it’s easiest to handle because I get notifications and can take it from there. | 06:05:55 | |
| 17:39:40 | ||
| 16 Jul 2024 | ||
| 23:17:06 | ||
| 23 Jul 2024 | ||
| 08:22:40 | ||
| 24 Jul 2024 | ||
| 10:14:59 | ||
| 26 Jul 2024 | ||
| 06:40:20 | ||
| Hey folks -- I'd like to make the NixOS manual and the Nixpkgs manual be exposed in Any objections or redirections before I do that?> | 16:59:40 | |
| * Hey folks -- I'd like to make the NixOS manual and the Nixpkgs manual be exposed in Any objections or redirections before I do that? | 16:59:42 | |
In reply to @philiptaron:matrix.orgGreat stuff, thanks a lot! | 17:07:06 | |
| Will this trigger one rebuild for every PR touching modules in any way? | 17:07:55 | |
| Only if the documentation changes, I think. | 17:10:16 | |
| * Only if the documentation changes, I think. But I don't know. | 17:10:31 | |
fricklerhandwerk: regarding your comment, note that doc/default.nix and doc/shell.nix remain: the guts of how they're implemented move over. | 17:11:14 | |
| I think that's the way it ought to be. | 17:11:25 | |
| like nixos-install-tools and tests.nixos-functions.nixos-test already do | 17:11:45 | |
In reply to @philiptaron:matrix.orgI understand, and splitting that into two parts doesn't make much sense to me. I suggest not breaking locality | 17:12:10 | |
| Hmmm, I really liked how doc/ was now the actual documentation and there wasn't what I considered to be an awkward doc-support directory that wasn't documentation. But I'll take your feedback. | 17:14:31 | |
In reply to @philiptaron:matrix.orgI understand, but arguably none of that content should actually live in there, and instead be right in or next to the code it's documenting | 17:18:56 | |
| And also the glue code is hardly separable from the content structure that it helps produce | 17:19:24 | |