!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

436 Members
Discussion about documentation improvements around the Nix ecosystem92 Servers

Load older messages


SenderMessageTime
25 May 2023
@asymmetric:matrix.dapp.org.ukasymmetricI won’t be able to attend today, sorry!13:00:30
@raitobezarius:matrix.orgraitobezarius changed their display name from raitobezarius to disko in NixOS 23.11 when.13:32:21
@raitobezarius:matrix.orgraitobezarius changed their display name from disko in NixOS 23.11 when to raitobezarius.13:37:27
26 May 2023
@pennae:matrix.eno.spacepennae zmitchellfricklerhandwerk: do we have any feedback about keeping/dropping the epub export (temporarily) yet? 15:07:25
@infinisil:matrix.orginfinisil
In reply to @pennae:matrix.eno.space
zmitchellfricklerhandwerk: do we have any feedback about keeping/dropping the epub export (temporarily) yet?
How about we change the epub to be just a single page telling users that it's deprecated and linking to the html manual instead. Also to report it in an issue if somebody depends on epub.
15:42:26
@pennae:matrix.eno.spacepennaewe can do that. all we need is a decision which way to go15:43:06
@infinisil:matrix.orginfinisilIf we don't have any feedback to epub, I think that idea is what we should do. In particular now that the release is branched off, so users have lots of time to report that they need epub until the next release15:44:20
@pennae:matrix.eno.spacepennaeif anyone wants to implement epub export in nixos-render-docs before that (jan tojnar offered i think) we can keep it too15:44:23
@infinisil:matrix.orginfinisilThe epub feels like baggage we don't really have the resources to maintain, so I'd rather drop it until we have a significant user base that needs it15:45:11
@infinisil:matrix.orginfinisil * The epub feels like baggage we don't really have the resources to maintain, so I'd rather drop it unless we have a significant user base that needs it15:45:20
@pennae:matrix.eno.spacepennaekeeping docbook around to produce a placeholder epub that only as a link and a deprecation notice is just so ironic15:48:06
@pennae:matrix.eno.spacepennaebut that's fine too. we're just not going to start moving properly on the nixpkgs manual conversion and removing docbook from the nixos manual completely until this is fixed. maybe we should have a vote or something15:49:14
@infinisil:matrix.orginfinisil pennae: It's effectively a constant document at that point, so docbook generation wouldn't even be necessary anymore, I'd be fine with it just being a rendered epub hosted somewhere that we just pkgs.fetch* :P 16:13:11
@pennae:matrix.eno.spacepennae nixos/doc/epub/is-deprecated.epub 16:14:13
@pennae:matrix.eno.spacepennaesure, also fine. amounts to dumping a blob into git which doesn't feel too nice, but it's small enough vs the rest of nixpkgs to not matter :)16:14:54
@infinisil:matrix.orginfinisilOh yeah that sounds good too πŸ˜†16:15:24
@pennae:matrix.eno.spacepennae nixos manual could drop docbook today if we (even just temporarily) deprecate docbook, nixpkgs manual is a bit out but shouldn't be by too much. we've experimented in the past and got the manual to render, but haven't checked for content equality and it's been a few months now too 16:20:43
@joepie91:pixie.townjoepie91 πŸ³οΈβ€πŸŒˆhttps://nixos.org/learn.html is broken again, in the same way as quite some time ago22:15:38
@joepie91:pixie.townjoepie91 πŸ³οΈβ€πŸŒˆ(missing text)22:16:25
@kranzes:matrix.org@kranzes:matrix.org
In reply to @joepie91:pixie.town
https://nixos.org/learn.html is broken again, in the same way as quite some time ago
If you can fix it here https://github.com/NixOS/nixos-homepage, please do so. I'll merge it.
22:28:48
@joepie91:pixie.townjoepie91 πŸ³οΈβ€πŸŒˆI'm unfortunately extremely low on spoons at the moment, so I can't really - just wanted to make sure people were aware22:29:49
@kranzes:matrix.org@kranzes:matrix.orgπŸ‘οΈ22:30:16
27 May 2023
@tfortmuller:matrix.orgtfortmuller joined the room.07:13:34
@jtojnar:matrix.orgJan Tojnar rski: hi, why did you undo https://nixos.wiki/index.php?title=Overlays&diff=7472&oldid=6543, there is no rationale in the edit summary 11:20:09
@mjolnir:nixos.orgNixOS Moderation Botchanged room power levels.16:40:28
29 May 2023
@abathur:matrix.orgabathur
In reply to @kranzes:matrix.org
If you can fix it here https://github.com/NixOS/nixos-homepage, please do so. I'll merge it.
https://github.com/NixOS/nixos-homepage/pull/1054 was opened when I passed along a query about this
16:08:50
@ners:nixos.devners joined the room.20:53:57
31 May 2023
@alper-celik:matrix.orgAlper Γ‡elik joined the room.10:53:00
1 Jun 2023
@ruby:isincredibly.gayruby changed their profile picture.07:07:58
@ruby:isincredibly.gayruby changed their profile picture.07:34:38

Show newer messages


Back to Room ListRoom Version: 6