!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

416 Members
Discussion about documentation improvements around the Nix ecosystem84 Servers

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


SenderMessageTime
10 Mar 2024
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @fricklerhandwerk:matrix.org
Also this: https://github.com/static-nix/styx
* It even renders its own documentation. I'd still recommend against it, because it follows the same paradigm as any other static site generator. You won't gain much.
10:36:43
@fricklerhandwerk:matrix.orgfricklerhandwerk *

It even renders its own documentation: https://styx-static.github.io/styx-site/documentation/

I'd still recommend against it, because it follows the same paradigm as any other static site generator. You won't gain much.

10:37:15
@johannes.kirschbauer:scs.ems.host@johannes.kirschbauer:scs.ems.hostThis styx thing looks like a differently styled version of our huge single page manual. My mouse catched fire from scrolling around inside of it^^10:44:35
@johannes.kirschbauer:scs.ems.host@johannes.kirschbauer:scs.ems.hostNavigation is a bit better because it has the static side bar. Seems really low in terms of interactivity. I know this is not serious. Just exploring what other people do 🌕️10:47:07
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @johannes.kirschbauer:scs.ems.host
This styx thing looks like a differently styled version of our huge single page manual.
My mouse catched fire from scrolling around inside of it^^
🙄 Yeah that's merely about some parameter juggling. Apart from that, there always should be single-page rendering, and that's just as much of a valid way for reading documents. I think it's a regression that the Nix manual did not keep the single page as an alternative. The dynamic search sucks, and you effectively need an entire web browser for it to work.
10:47:14
@johannes.kirschbauer:scs.ems.host@johannes.kirschbauer:scs.ems.host
In reply to @fricklerhandwerk:matrix.org
🙄 Yeah that's merely about some parameter juggling. Apart from that, there always should be single-page rendering, and that's just as much of a valid way for reading documents. I think it's a regression that the Nix manual did not keep the single page as an alternative. The dynamic search sucks, and you effectively need an entire web browser for it to work.
Oh good point. I think i'll add this to danielsidhion's list
10:48:07
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @johannes.kirschbauer:scs.ems.host
Navigation is a bit better because it has the static side bar.
Seems really low in terms of interactivity.

I know this is not serious. Just exploring what other people do 🌕️
And that is literally style sheet juggling
10:48:13

Show newer messages


Back to Room ListRoom Version: 6