!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

408 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.frNixOS for the modules configurations.12:23:40
@johannes.kirschbauer:scs.ems.host@johannes.kirschbauer:scs.ems.hostAh okay understood.12:23:54
@picnoir:alternativebit.fr@picnoir:alternativebit.frNixpkgs for the language-specific build systems.12:23:54
@johannes.kirschbauer:scs.ems.host@johannes.kirschbauer:scs.ems.host

Good concern. Implementing a simple redirection endpoint is quite hard. because most of the manuals are just one single page behind a single url.
Anchor tags #section-name are not sent to the server. This means it is essentially impossible to redirect from the old link to a new location.
Because from a server perspective

https://nixos.org/manual/nixpkgs/stable/#__placeA__

is exactly the same as

https://nixos.org/manual/nixpkgs/stable/#__placeB__

12:28:55
@johannes.kirschbauer:scs.ems.host@johannes.kirschbauer:scs.ems.host

When a URL with an anchor tag is accessed, the browser uses the tag to scroll to a specific section of the page without making a server request for the anchor. The server only receives the part of the URL preceding the #.

12:30:37
@johannes.kirschbauer:scs.ems.host@johannes.kirschbauer:scs.ems.host * When a URL with an anchor tag is accessed, the browser uses the tag to scroll to a specific section of the page without making a server request for the anchor. The server only receives the part of the URL preceding the #.12:30:43
@johannes.kirschbauer:scs.ems.host@johannes.kirschbauer:scs.ems.host *

Good concern. Implementing a simple redirection endpoint is quite hard/impossible. because most of the manuals are just one single page behind a single url.
Anchor tags #section-name are not sent to the server. This means it is essentially impossible to redirect from the old link to a new location.
Because from a server perspective

https://nixos.org/manual/nixpkgs/stable/#__placeA__

is exactly the same as

https://nixos.org/manual/nixpkgs/stable/#__placeB__

12:35:24
@johannes.kirschbauer:scs.ems.host@johannes.kirschbauer:scs.ems.hostThis means migrating to any form of multipage documentation will always break the external links. And there is unfortunately nothing we can do about it. ( At least not something i am aware of )12:37:46
@johannes.kirschbauer:scs.ems.host@johannes.kirschbauer:scs.ems.hostIn my opinion, the root of our current issues stems from the overuse of anchor tags. This overreliance has led to regressions and breakages that we're now struggling to address. The longer we delay taking action, the more severe and complex these problems become, exacerbating the situation further.12:40:11
@picnoir:alternativebit.fr@picnoir:alternativebit.frWhat's the motivation behind migrating away from nixos.org?12:40:16
@johannes.kirschbauer:scs.ems.host@johannes.kirschbauer:scs.ems.hostnixos.org is just a domain. I saw the dicusssion that we could host the content of nix.dev on nixos.org. Migration is mainly happening at the content level12:41:53
@johannes.kirschbauer:scs.ems.host@johannes.kirschbauer:scs.ems.hostafaik12:42:14
@picnoir:alternativebit.fr@picnoir:alternativebit.frRight!12:44:28
@picnoir:alternativebit.fr@picnoir:alternativebit.fr

I was talking about

At some point we agreed to move the manuals to nix.dev, yes. I don't have the source right now.

I still intend to make it happen one way or another. I started in October and didn't manage to finish yet because of conflicting priorities due to too many responsibilities.

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

12:44:50

Show newer messages


Back to Room ListRoom Version: 6