Just an update on this website revamp idea and why I haven't moved forward yet - of course after proposing it I started thinking about whether it would be much nicer to just immediately go for a complete reimplementation using a modern web stack. That brought up many issues to solve, but the main one is the following: most JS docs site builders these days expect MDX (Markdown with React-ish extensions) as an input format for docs pages, whereas we have plain Markdown pages that not only come from the current website repo, but also from historic branches of various releases of Prometheus and the Alertmanager. A lot of Markdown parses fine as MDX, but there are many constructs in our Markdowns that blow up the MDX compiler in my experiments (like `<string>` and stuff like that). If we only had current docs, that would be less of a problem (because we could just adjust things there), but if we need to pull in old versions of docs from other repos, then it's harder to solve. We'd either have to update the docs in all the old release branches or do some kind of pre-processing-patching on them to get rid of incompatibilities before using them as MDX. It would still be super nice to get rid of the old nanoc-based site at some point though.
Anyway, I'm still thinking about this and how to best approach it :) On Fri, Sep 20, 2024 at 7:23 AM Julius Volz <julius.v...@gmail.com> wrote: > Hi, > > The Prometheus homepage (prometheus.io) looks very dated by now, and I > wouldn't be surprised if it turns off a lot of first-time visitors just by > its looks. While I don't have the capacity to make this another major > project at the moment, in lieu of a more extensive docs & homepage rework, > what do people think about me just working to update the design of the > landing page to make it look at least slightly more modern? I was thinking > of this kind of direction (just a start): > > https://prometheus-new.netlify.app/ > > (user logos are blurry because many never provided us SVGs - this would > have to be fixed) > > This would mainly change the landing page, although of course the fonts > and a few styles would also have to be updated on other pages to make them > consistent. But that should stay a minor change. > > I built the quick demo above using a more modern tech stack (Mantine, > React + JSX, etc.) than our homepage, but I could try to backport the same > styles to our old homepage framework with pure HTML + CSS. Eventually it > would be really nice to port the homepage to a less medieval static site > builder, but that's a much much larger project. > > Cheers, > Julius > -- 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 prometheus-developers+unsubscr...@googlegroups.com. To view this discussion visit https://groups.google.com/d/msgid/prometheus-developers/CA%2BT6Yoy%2BHC%3DqzpwF8KoL3qjcHXO1jp-RaaxzyTss%2B1Mb9CN2jA%40mail.gmail.com.
