I browsed a few pages to get a feel for it:

  https://dashorst.github.io/wicket-site/reveal-site/guide/why-wicket.html
  https://dashorst.github.io/wicket-site/reveal-site/guide/model-types.html

https://dashorst.github.io/wicket-site/reveal-site/guide/lambda-models.html
  https://dashorst.github.io/wicket-site/reveal-site/guide/cdi.html

https://dashorst.github.io/wicket-site/reveal-site/guide/first-application.html

The user guide looks great. The text reads naturally and explains each
topic well. The CDI page, for instance, turned out to be a better how-to
than the CDI section in the current guide [1].

A few minor points:

- The previous restructuring proposal (from April) introduced the four
  kinds of documentation (tutorials, how-tos, explanations and reference)
  right on the first page. I missed having that overview up front in this
  version.

- The two header lines

    User guide / <topic>
    <Explanation|Reference|How-to|Tutorial> Wicket 10 and later

  could be merged into one. That would show readers where they are in the
  documentation right away and save some vertical space.

- model-types.html prefixes some types with part of their package name,
  e.g. util.ListModel<T>.

1 -
https://nightlies.apache.org/wicket/guide/11.x/single.html#_integrating_wicket_with_cdi

Pedro Santos

Em ter., 13 de out. de 2026 às 09:19, Ernesto Reinaldo Barreiro <
[email protected]> escreveu:

> Wonderful work!
>
> On Tue, Oct 13, 2026 at 4:32 AM Martijn Dashorst <
> [email protected]>
> wrote:
>
> > my claude has made a transformation from the user reference guide to
> > diataxis how-tos, tutorials, explainers and references, including search.
> >
> > The idea is to keep the reference manual as the source of truth and
> > generate the newer versions of the diataxis docs using the modifications.
> >
> > https://dashorst.github.io/wicket-site/reveal-site/guide/
> >
> > https://dashorst.github.io/wicket-site/departure-board/guide/
> >
> > The docs are of course based on the guide, but I don't think they read
> too
> > much as AI slop.
> >
> > I think the 137 documents are a really good documentation site, next to
> the
> > awesome user reference guide.
> >
> > WDYT?
> >
> > Martijn
> >
> > Become a Wicket expert, learn from the best: http://wicketinaction.com
> >
>
>
> --
> Regards -
> Ernesto Reinaldo Barreiro
> Apache Wicket Committer
> Emerging artist
> https://www.instagram.com/reinaldo.barreiro.art/
>

Reply via email to