| 8 Mar 2024 |
 raitobezarius | I just want to make a note that the new tech stack for the website has already created a staggering amount of regressions, I hope that the panic of regressions on the documentation stack will be unfounded. | 16:34:05 |
| 9 Mar 2024 |
 djacu | In reply to @raitobezarius:matrix.org
I just want to make a note that the new tech stack for the website has already created a staggering amount of regressions, I hope that the panic of regressions on the documentation stack will be unfounded. You mean the nixos.org homepage's move to astro+tailwind? What regressions have you noticed? | 06:59:59 |
| 10 Mar 2024 |
|  @stablejoy:matrix.org joined the room. | 04:09:32 |
| @stablejoy:matrix.org | How can one integrate more of the manuals and documentation directly with Nix? Like if Nix could handle a greater share of the workload, maintaining the website might become simpler. Meaning if it can package anything can it package a website manual in a way? | 04:19:30 |
 fricklerhandwerk | In reply to @stablejoy:matrix.org
How can one integrate more of the manuals and documentation directly with Nix? Like if Nix could handle a greater share of the workload, maintaining the website might become simpler. Meaning if it can package anything can it package a website manual in a way? It is in principle possible to write a static site generator in the Nix language, if that's what you mean. It has been done at least once. Whether that will make anything simpler to maintain is a matter of implementation quality and maturity of language tooling.
The practical question is always "who's gonna do it". And as @pennae said, we already have something that works. Someone just has to dig into it and make things happen.
| 09:07:08 |
| raitobezarius | Refer to the GitHub issues that samueldr opened | 09:55:36 |
 @johannes.kirschbauer:scs.ems.host | In reply to @stablejoy:matrix.org
How can one integrate more of the manuals and documentation directly with Nix? Like if Nix could handle a greater share of the workload, maintaining the website might become simpler. Meaning if it can package anything can it package a website manual in a way? https://cs.tvl.fyi/depot/-/blob/users/sterni/nix/html/README.md
You mean something like this?
A dsl (by sterni for directly rendering html from nix code, of course this has major performance issues and i you'd be crazy to use it productively but its certainly an interesting experiement.
| 10:33:03 |
| fricklerhandwerk | Also this: https://github.com/static-nix/styx | 10:33:58 |
 ma27 | In reply to @johannes.kirschbauer:scs.ems.host
https://cs.tvl.fyi/depot/-/blob/users/sterni/nix/html/README.md
You mean something like this?
A dsl (by sterni for directly rendering html from nix code, of course this has major performance issues and i you'd be crazy to use it productively but its certainly an interesting experiement.
OMG it's beautiful! | 10:34:31 |
| fricklerhandwerk | 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. | 10:36:26 |
| fricklerhandwerk | 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 | * 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 | 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^^ | 10:44:35 |
| @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 🌕️ | 10:47:07 |
| fricklerhandwerk | 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 | 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 | 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 |
| fricklerhandwerk | The serious questions I would ask about a data transformation engine (which a static site generator is):
- What are the programmable interfaces?
- What are the data structures it transforms?
- Which languages are used to define data and transformations?
| 10:53:25 |
| fricklerhandwerk | Here's one from a different ecosystem: https://docs.racket-lang.org/scribble/ | 10:53:46 |
| 11 Mar 2024 |
|  wamirez changed their display name from Daniel Ramirez to wamirez. | 10:57:18 |
| wamirez changed their profile picture. | 10:57:23 |
