On Wed, Oct 14, 2020 at 6:54 PM Tobias Schmidt <[email protected]> wrote:
> It'd be rad to see a complete site overhaul! The UI could definitely see a > lot of improvements, so does our documentation structure actually. > > Though, I'm not so keen on adopting a JS site builder for Prometheus. > Compilation speed has already been brought up, but the more important > factor is that the prometheus is predominantly a Go project with Go > experience being by far the highest. I have helped a friend with a larger > JS project in the last months and the average number of JS dependencies and > churn in the ecosystem make me very sceptical about us having the capacity > to maintain it properly. In my humble opinion we'd fare better using Hugo > as site generator. > I'd offer some counter points: Working with Typescript and React / JSX / TSX / CSS Modules (all of which you get with Gatsby) is sooo productive in comparison to doing Go-based HTML templating. You get a thoroughly typed representation of your site across code, styling, and content, with amazing tooling right in your editor. Frederic seems to have recently discovered this himself :) https://twitter.com/fredbrancz/status/1314219293224169474 I'm not too worried about dependencies, as they might be many, but they have never really gotten in my way, install really fast, and the big ecosystem has packages to do pretty much anything you might want. > Funny enough, just last night I started working on the long-standing > request to automate the repository docs compilation, so that the site > updates on new prometheus/alertmanager releases automatically. I have it > almost ready - but oh boy is our navigation code a nightmare. I have the > feeling the main issue for our compilation speed is the menu generation and > quite a few nested loops which get executed every time. > Great! The menu generation is exactly what Julien optimized through caching last time: https://github.com/prometheus/docs/pull/1662 It did make the code more complicated than it already was, but the speedup was big. Hopefully this will actually work better with Gatsby :) > On Wed, Oct 14, 2020 at 6:26 PM Julius Volz <[email protected]> wrote: > >> On Wed, Oct 14, 2020 at 6:20 PM Julien Pivotto < >> [email protected]> wrote: >> >>> I am 1000% for this, but it gatsby a replacement for nanoc? >>> >> >> Yes. It's a JS/TS-based static site builder that would completely replace >> nanoc if we determine that the compilation speed is ok. >> >> -- >> You received this message because you are subscribed to the Google Groups >> "Prometheus Developers" group. >> To unsubscribe from this group and stop receiving emails from it, send an >> email to [email protected]. >> To view this discussion on the web visit >> https://groups.google.com/d/msgid/prometheus-developers/CA%2BT6YoyOodu6ySV1CfdKunNdsrDue_7bjH_4_1SqH1zKRekvng%40mail.gmail.com >> <https://groups.google.com/d/msgid/prometheus-developers/CA%2BT6YoyOodu6ySV1CfdKunNdsrDue_7bjH_4_1SqH1zKRekvng%40mail.gmail.com?utm_medium=email&utm_source=footer> >> . >> > -- You received this message because you are subscribed to the Google Groups "Prometheus Developers" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To view this discussion on the web visit https://groups.google.com/d/msgid/prometheus-developers/CA%2BT6YozZQSp9KTtWHgd6tcE-19T7OtDd1Gc06fk%2BSP-A%2Bp9kxQ%40mail.gmail.com.
