Hi, I like them both! I think the user guide is more focused this way!
I noticed few minor issues: - the color of the text in the footer does not have enough contrast and this makes it hard to read (dark gray on black background) - https://dashorst.github.io/wicket-site/docs/howtos/integration/use-websockets/ - 1) some code snippets are rendered as plain text; 2) some snippets are not highlighted On Sun, Apr 12, 2026 at 11:35 PM Martijn Dashorst < [email protected]> wrote: > I've been playing with Claude this weekend and wanted to try to see where > we could end up. You've already seen the small, minor changes to the user > reference guide. > > But I've been dreaming bigger. The user reference guide is awesome, but > I have the feeling you are going to implement your ideas/dreams for Wicket 11 with CC too :-) > also one giant wall of text. I find that I like the diataxis documentation > framework quite enlightning for structuring documentation. The user > reference manual is a perfect example of trying to be everything for all > there is to know for all the possible goals one could have. > > So I instructed Claude to: > - come up with a new design > - restructure the user reference guide documentation into the four > categories that exist: howtos, reference, tutorials and explanations. > - add search and categories (click on howtos) to the docs page > > The product can be found here: https://dashorst.github.io/wicket-site/ > > The newly structured documentation is here: > https://dashorst.github.io/wicket-site/docs/ > > I hope you like it, but as this is AI transformed, I'm not overly attached > to it, so no need to be (too) gentle. > > Martijn >
