!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

407 Members
Discussion about documentation improvements around the Nix ecosystem80 Servers

You have reached the beginning of time (for this room).


SenderMessageTime
14 Mar 2024
@federicodschonborn:matrix.org@federicodschonborn:matrix.org left the room.02:04:32
@danielsidhion:nixos.devdanielsidhion Draft PR to fix the stylesheet situation: https://github.com/NixOS/nixpkgs/pull/295847
Automatic header link buttons are still not there, because I need to extend nixos-render-docs more to allow that. Regardless of it, I appreciate anyone who can check out that PR, build the manuals (nix build .#htmlDocs.nixpkgsManual and nix build .#htmlDocs.nixosManual) and inspect the new styles and let me know if they see anything that needs fixing
10:47:43
@johannes.kirschbauer:scs.ems.host@johannes.kirschbauer:scs.ems.host

Question what outputs of our documentation do exist ?

Someone confirm / disagree with this list?

NixOS manual

Web
man page
epub

nixpkgs manual

Web
epub
11:53:00
@johannes.kirschbauer:scs.ems.host@johannes.kirschbauer:scs.ems.host Is there a specific reason, why there is no attribute like pkgs.docs.<output> at all? Wouldn't it be nice if our manual could be build as part of our package collection? 12:05:52
@johannes.kirschbauer:scs.ems.host@johannes.kirschbauer:scs.ems.host * Is there a specific reason, why there is no attribute like pkgs.docs.<output> at all? Wouldn't it be nice if our manuals could be build as part of our package collection? 12:06:05
@johannes.kirschbauer:scs.ems.host@johannes.kirschbauer:scs.ems.hostOr is that just because nobody added them yet.12:06:31
@johannes.kirschbauer:scs.ems.host@johannes.kirschbauer:scs.ems.host * Is there a specific reason, why there is no attribute like pkgs.docs.<output> at all? Wouldn't it be nice if our manuals could be built as part of our package collection? 12:06:41
@picnoir:alternativebit.fr@picnoir:alternativebit.fr joined the room.12:07:06
@johannes.kirschbauer:scs.ems.host@johannes.kirschbauer:scs.ems.host * Is there a specific reason, why there is no attribute like pkgs.docs.<output> at all? Wouldn't it be nice if our manuals could be built as part of our package collection? This would make it easier to answer the "outputs" question. 12:08:02
@picnoir:alternativebit.fr@picnoir:alternativebit.fr

Hey, I just stumbled upon this:

At some point we agreed to move the manuals to nix.dev

https://github.com/NixOS/nixos-homepage/issues/1251#issuecomment-1994193106

Not sure what is the best place to discuss this. Obviously not the above issue :)

I'd like to voice some concern about that: there's a lot of hyperlinks pointing to the manual on the web. Doing so will break those for little benefit.

12:09:00
@picnoir:alternativebit.fr@picnoir:alternativebit.fr *

Hey, I just stumbled upon this:

At some point we agreed to move the manuals to nix.dev

https://github.com/NixOS/nixos-homepage/issues/1251#issuecomment-1994193106

Not sure what is the best place to discuss this. Obviously not the above issue :) So let's go with this matrix channel.

I'd like to voice some concern about that: there's a lot of hyperlinks pointing to the manual on the web. Doing so will break those for little benefit.

12:09:17
@johannes.kirschbauer:scs.ems.host@johannes.kirschbauer:scs.ems.host * Or is that just because nobody added them yet. (Some are in flake.nix it seems but not in the pkgs itself) 12:10:13

Show newer messages


Back to Room ListRoom Version: 6