Nix Documentation | 433 Members | |
| Discussion about documentation improvements around the Nix ecosystem | 89 Servers |
| Sender | Message | Time |
|---|---|---|
| 7 Mar 2024 | ||
In reply to @efx:matrix.orgBy stable reference manual do you mean the nixpkgs manual? Just want to be sure, because we have 3 "big manuals", one for nix, one for nixos, and another for nixpkgs | 17:55:32 | |
In reply to @danielsidhion:nixos.devgood question! my "search the docs" tends to round robin those. Lately I've trying to stick to the nix stable manual. Though I'll read nix unstable manual as I assume unstable may have more accurate documentation. | 17:56:58 | |
| Perhaps we mention a workaround to this issue here https://nix.dev/guides/troubleshooting? | 18:02:09 | |
I began this quest with nix-store command not found error messages when I started trying nix copy. | 18:02:51 | |
In reply to @efx:matrix.orgimo the software should either fix the bug or admit to the bug and link to a help page | 18:03:28 | |
| which links to bug reports say | 18:03:37 | |
| change the error message to tell you a Web site that says how to fix it | 18:04:09 | |
That would be nice! that would be a patch to nix ? | 18:04:37 | |
| yeah | 18:08:48 | |
| trivial uncontroversial patches like that one will be merged very promptly | 18:09:23 | |
| I read through the GitHub links and found this open PR that tried to add an error message: https://github.com/NixOS/nix/pull/6628. Prior art we might consider rallying to address. I know not C++ | 19:29:38 | |
| Also, Determinate Systems had documentation in their readme that they've since removed. Their nix-installer appears to fix the issue (https://github.com/DeterminateSystems/nix-installer/pull/714) | 19:35:47 | |
| Google Season of Docs applications are now open: https://developers.google.com/season-of-docs/docs/timeline | 21:42:43 | |
In reply to @jade_:matrix.orgI wonder if we couldn't do something in nixpkgs that would be a ready-to-go sshd that's specific to ssh-ng 🤔 | 21:44:39 | |
In reply to @jade_:matrix.org* I wonder if we couldn't do something in nixpkgs that would be a ready-to-go As in, it doesn't depend on outside state, and is configured exclusively for use with being used as a Nix builder. | 21:45:40 | |
In reply to @philiptaron:matrix.orgthe actual more reasonable thing here is a ssh service/subsystem/whateveritis like sftp | 21:48:56 | |
In reply to @jade_:matrix.orgNow that's a flavor I haven't heard in forever. Does anyone else do that?! | 21:49:30 | |
| subsystem seems like the absolute cleanest way of doing this tbqh, but putting PATH stuff in a drop in for sshd_config somewhere would also work | 21:55:44 | |
In reply to @jade_:matrix.orgDo you see a way of doing a drop-in style config? sshd_config isn't making me see any. I agree after reading the docs on subsystem that a nix subsystem would be 🔥 | 22:12:49 | |
| at least archlinux has /etc/ssh/sshd_config.d | 22:14:48 | |
In reply to @jade_:matrix.org* Do you see a way of doing a drop-in style config? sshd_config isn't making me see any. I agree after reading the docs on subsystem that a nix or nix-daemon subsystem would be 🔥 | 22:14:50 | |
| but i am guessing it is a distro thing maybe? | 22:15:04 | |
| That would be super lame. | 22:15:14 | |
| Of course it is: https://manpages.debian.org/unstable/openssh-server/sshd_config.5.en.html
| 22:23:46 | |
| fixing bad distro decisions in the installer seems a bit questionable, because of peoples jank configuration management systems or suchlike | 22:36:32 | |
| yeah, running a completely separate sshd seems more kosher to me. | 23:00:30 | |
| 23:13:13 | ||
| i'm looking at a doc PR which has a 23.11 backport label. Is it common to backport doc fixups? | 23:14:07 | |
| 8 Mar 2024 | ||
| 02:33:33 | ||
| so re: https://discourse.nixos.org/t/2024-03-07-documentation-team-meeting-notes-112/40963
is this about presentation frameworks for rendered outputs, or for actual splitting? because actual splitting has been there from day one (html:into-file), which we feel is being forgotten on a weekly basis | 02:35:06 | |