News for hackers. Stuff that matters.
Re:Nix: An idea whose time has come by octoberfranklin on Friday February 18, 2022 @09:02PM (#30393751)
Plus the nixpkgs and nixos docs are generated from some weird hybrid docbook-markdown that mere mortals (well me at least) can't get to build. So we are stuck using the makes-my-eyes-bleed font on nixos.org, and the gigantic mile-long single-page manual format (which is nice sometimes, like for searching, but other times you want a TOC sidebar).

The documentation for the nix language is all done in mdbook, and is beautiful and easy to read. I wish the nixpkgs/nixos manuals were like that.

Re:Nix: An idea whose time has come by 1_player on Saturday February 19, 2022 @06:49AM (#30396400)
> makes-my-eyes-bleed font on nixos.org

AKA the curse of macOS designers that have that setting that makes all fonts a little bolder, so they think 300 weight is perfectly acceptable for a documentation site, while everybody else have to strain their eyes to read too thin a black font on eye watering white for hours.

Just go on nixos.org, remove the font-weight: 300 and see how much readable it is.