Hi all, We use Hugo with Docsy to build the Polaris project's web site. The scripts used to generate the web site haven't been "polished" since the initial launch of the Hugo-based website back in 2024.
For reference: Hugo version used: 0.123.7 (released in March 2024, via Ubuntu 24.04) Hugo version, recent: 0.157.0 (released yesterday) Docsy version used: 0.10.0 (released in May 2024) Docsy version current: 0.14.3 (released last week) The new versions enable a few nice features: 1. Nicer code blocks using "Chroma" with a "Copy" button, syntax highlighting and line numbering 2. "GitHub/Obsidian/Typora style" alerts that render nicely on GitHub and in IntelliJ as well. IIRC the new versions also have better support for Mermaid renderings. The "look and feel" of the web site does not change. There are two minor differences though: 1. The "Get Started" button now looks "flat." 2. Some headings on the new "Configuration Reference" page are a bit more distinguishable. The PR [3895] is up and ready for review. Because new Docsy and likely also new Hugo versions could easily "break" the website's layout, we should avoid automatic dependency management for it. Cheers, Robert [3895] https://github.com/apache/polaris/pull/3895
