My Roq documentation site had page lists that drifted away from the Markdown. I moved membership and ordering into page metadata, then used Qute @TemplateExtension methods to build the views. I also connected shared Excalidraw sources through Roq Data and ran Pagefind after static generation in Maven. The article covers the code choices and their limits. https://www.the-main-thread.com/p/quarkus-roq-documentation-sites #Quarkus #Roq #Java