!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

395 Members
Discussion about documentation improvements around the Nix ecosystem79 Servers

Load older messages


SenderMessageTime
7 Mar 2024
@jade_:matrix.org@jade_:matrix.orgwhich links to bug reports say18:03:37
@jade_:matrix.org@jade_:matrix.orgchange the error message to tell you a Web site that says how to fix it18:04:09
@efx:matrix.orgEli Flanagan That would be nice! that would be a patch to nix ? 18:04:37
@jade_:matrix.org@jade_:matrix.orgyeah 18:08:48
@jade_:matrix.org@jade_:matrix.orgtrivial uncontroversial patches like that one will be merged very promptly18:09:23
@efx:matrix.orgEli FlanaganI 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
@efx:matrix.orgEli FlanaganAlso, 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
@fricklerhandwerk:matrix.orgfricklerhandwerkGoogle Season of Docs applications are now open: https://developers.google.com/season-of-docs/docs/timeline21:42:43
@philiptaron:matrix.orgPhilip Taron (UTC-8)
In reply to @jade_:matrix.org
unsure. i think the rc file isn't read at all, yeah? then i think some sshd config drop in ought to be added to the installer unless you have better ideas
I 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
@philiptaron:matrix.orgPhilip Taron (UTC-8)
In reply to @jade_:matrix.org
unsure. i think the rc file isn't read at all, yeah? then i think some sshd config drop in ought to be added to the installer unless you have better ideas
*

I wonder if we couldn't do something in nixpkgs that would be a ready-to-go sshd that's specific to ssh-ng 🤔

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
@jade_:matrix.org@jade_:matrix.org
In reply to @philiptaron:matrix.org

I wonder if we couldn't do something in nixpkgs that would be a ready-to-go sshd that's specific to ssh-ng 🤔

As in, it doesn't depend on outside state, and is configured exclusively for use with being used as a Nix builder.

the actual more reasonable thing here is a ssh service/subsystem/whateveritis like sftp
21:48:56
@philiptaron:matrix.orgPhilip Taron (UTC-8)
In reply to @jade_:matrix.org
the actual more reasonable thing here is a ssh service/subsystem/whateveritis like sftp
Now that's a flavor I haven't heard in forever. Does anyone else do that?!
21:49:30
@jade_:matrix.org@jade_:matrix.orgsubsystem seems like the absolute cleanest way of doing this tbqh, but putting PATH stuff in a drop in for sshd_config somewhere would also work21:55:44
@philiptaron:matrix.orgPhilip Taron (UTC-8)
In reply to @jade_:matrix.org
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
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 subsystem would be 🔥
22:12:49
@jade_:matrix.org@jade_:matrix.orgat least archlinux has /etc/ssh/sshd_config.d22:14:48
@philiptaron:matrix.orgPhilip Taron (UTC-8)
In reply to @jade_:matrix.org
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
* 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
@jade_:matrix.org@jade_:matrix.orgbut i am guessing it is a distro thing maybe?22:15:04
@philiptaron:matrix.orgPhilip Taron (UTC-8)That would be super lame.22:15:14
@philiptaron:matrix.orgPhilip Taron (UTC-8)

Of course it is: https://manpages.debian.org/unstable/openssh-server/sshd_config.5.en.html

Note that the Debian openssh-server package sets several options as standard in /etc/ssh/sshd_config which are not the default in sshd(8):

Include /etc/ssh/sshd_config.d/*.conf
22:23:46
@jade_:matrix.org@jade_:matrix.orgfixing bad distro decisions in the installer seems a bit questionable, because of peoples jank configuration management systems or suchlike22:36:32
@philiptaron:matrix.orgPhilip Taron (UTC-8)yeah, running a completely separate sshd seems more kosher to me.23:00:30
@pederbs:pvv.ntnu.nopbsds joined the room.23:13:13
@pederbs:pvv.ntnu.nopbsdsi'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
@pennae:matrix.eno.space@pennae:matrix.eno.space joined the room.02:33:33
@pennae:matrix.eno.space@pennae:matrix.eno.space

so re: https://discourse.nixos.org/t/2024-03-07-documentation-team-meeting-notes-112/40963

@danielsidhion: Evaluating frameworks that could do multi-page renders for the Nixpkgs/NixOS manuals, making sure all necessary extensions and more are supported

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
@infinisil:matrix.orginfinisil Ping danielsidhion Johannes Kirschbauer @hsjobeki ^ 02:41:52
@infinisil:matrix.orginfinisilHaven't seen it often, but I guess there's no problem with it if it makes sense02:43:11
@pennae:matrix.eno.space@pennae:matrix.eno.space like, nrd exists for the express purpose of creating manuals at least as useful as docbook was, with xrefs from modules to options etc, and not create totally garbage manpage output like current nix does. the syntax extension are icing 02:43:13
@pennae:matrix.eno.space@pennae:matrix.eno.spacewe've recently been told that epub support is something at least a few still want, the infra behind html:into-file was with the express purpose of easily allowing any level of detail of splitting so you can make epub happen very easily. (it's not wired up for that right now, but it's like five lines of patch to do)02:44:41
@johannes.kirschbauer:scs.ems.host@johannes.kirschbauer:scs.ems.host

I understand the frustration you're experiencing, especially considering the significant effort you've invested into the project.

However, Danielsidhion and I are currently exploring alternative options because we're trying to providing the best possible experience for our users.

This sometimes entails re-thinking our current approach. Adopting an off-the-shelf rendering framework that offers customization options could significantly enhance user-friendliness while reducing complexity and maintenance work. Daniel has a list of needed features like page search, intuitive navigation, handling cross references, md plugins, live editing etc, ultimately improving the overall user experience.

I think we might need an RFC if we really want to migrate anyways. This would also allow potential epub users to show up.

07:52:41

Show newer messages


Back to Room ListRoom Version: 6