!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

409 Members
Discussion about documentation improvements around the Nix ecosystem80 Servers

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


SenderMessageTime
14 Mar 2024
@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
@johannes.kirschbauer:scs.ems.host@johannes.kirschbauer:scs.ems.host * Or is that just because nobody added them yet. (Web outputs are in flake.nix it seems but not in the pkgs itself) 12:10:49
@johannes.kirschbauer:scs.ems.host@johannes.kirschbauer:scs.ems.host
In reply to @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.

I think this matrix channel is always best for asking about documentation concerns.
12:18:41
@johannes.kirschbauer:scs.ems.host@johannes.kirschbauer:scs.ems.host

Picnoir: can you give some more details:

there's a lot of hyperlinks pointing to the manual on the web

What exact links, do you mean on the nixos website or in nix.dev?

the manual on the web.

Do you mean all the manuals? Or the nixpkgs manual ? or the nixos manual ?

12:22:01
@johannes.kirschbauer:scs.ems.host@johannes.kirschbauer:scs.ems.host *

Picnoir: can you give some more details:

there's a lot of hyperlinks pointing to the manual on the web

What exact links, do you mean on the nixos website or in nix.dev?

the manual on the web.

Do you mean all the manuals? Or the nixpkgs manual ? or the nixos manual ?

12:22:58
@picnoir:alternativebit.fr@picnoir:alternativebit.frI'm mostly talking about links living on blog posts and overall pages not controlled by the documentation team.12:23:03
@picnoir:alternativebit.fr@picnoir:alternativebit.fr * I'm mostly talking about links living on blog posts, wikis and overall pages not controlled by the documentation team.12:23:08
@johannes.kirschbauer:scs.ems.host@johannes.kirschbauer:scs.ems.host *

Picnoir: can you give some more details:

there's a lot of hyperlinks pointing to the manual on the web

What exact links, do you mean on the nixos website or in nix.dev?

the manual on the web.

Do you mean all the manuals? Or the nixpkgs manual ? or the nixos manual ?

12:23:27
@picnoir:alternativebit.fr@picnoir:alternativebit.frAnd yes, all three main manuals: Nix, NixOS and Nixpkgs12:23:27
@picnoir:alternativebit.fr@picnoir:alternativebit.frNix for the language bit12:23:35
@picnoir:alternativebit.fr@picnoir:alternativebit.frNixOS for the modules configurations.12:23:40
@johannes.kirschbauer:scs.ems.host@johannes.kirschbauer:scs.ems.hostAh okay understood.12:23:54

Show newer messages


Back to Room ListRoom Version: 6