Prometheus website switchover - new repo or old one?

[Julius Volz]

Hi,

The last few weeks I've been working a lot on the prometheus.io website rewrite using Next.js and a (hopefully) more modern and more responsive design. You can see a preview build here:

https://prometheus-next.netlify.app/

It reimplements all the major functionality of the old website regarding fetching, transforming, and displaying differently versioned docs from other repos, fetching component download information, and all that. It also adds a few new goodies, such as prev/next links on documentation pages, light/dark theme switching, syntax highlighting (though not for PromQL quite yet), and more.

Most features and pages are done, but a few obvious things (like integrating site search, the governance page, and a few other minor things and tweaks) are still missing. Anyway, I hope to complete things soon.

Currently the code just lives in my personal GitHub account at https://github.com/juliusv/prometheus-next-website in case anyone is curious what it looks like so far.

Two questions:

* Are people ok with the new site in general? I guess at this point, only minor tweaks make sense and are of course still possible any time after a launch, but the overall structure with Next.js and all are pretty fixed.

* Do people prefer overwriting the old "prometheus/docs" repository or putting the new site under a new repo name like "prometheus/docs-next" or "prometheus/website"?

Regarding the second question: The old & new implementations don't share any code, only some markdown files (local docs + blog posts, but moved to different directories and adjusted somewhat). Overall I don't feel strongly either way. A new repo would feel a bit cleaner when it comes to looking at the history of the code, although the opposite is true for the content files.

Cheers,

Julius

[Julius Volz]

Ok, the new website is 99.9% done now (see preview at https://prometheus-next.netlify.app/), so if people are fine with it, I would actually want to launch it sometime in the next few days.

Currently I have the code in https://github.com/juliusv/prometheus-next-website. The plan seems to be to reuse the existing old docs repo (https://github.com/prometheus/docs), but it would still be nice to preserve the commits I currently have in my separate repo, so my plan for grafting the two repo histories together is:

* Create a commit in the old docs repo with all old files deleted.

* Add a git remote for my new site's repo, fetch the history from that, and merge it (I tried rebasing it ontop of the deletion commit as well, but ran into trouble)

That would then look something like this as a huge PR: https://github.com/prometheus/docs/compare/docs-next

Will do that soon unless someone objects :)

Cheers,

Julius