You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@wicket.apache.org by Martijn Dashorst <ma...@gmail.com> on 2026/04/12 20:35:27 UTC
Proposal for a new Wicket website and user guide
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
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
Re: Proposal for a new Wicket website and user guide
Posted by Andrea Del Bene <an...@gmail.com>.
No problem!
On Mon, Apr 13, 2026 at 2:48 PM Martijn Dashorst <ma...@gmail.com>
wrote:
> On Mon, Apr 13, 2026 at 1:07 PM Andrea Del Bene <an...@gmail.com>
> wrote:
>
> > I've restored the site with an empty commit on asf-site 👍
> >
>
> You rock!
>
> Again, apologies for causing extra work.
>
> Martijn
>
--
Andrea Del Bene.
Apache Wicket committer.
Re: Proposal for a new Wicket website and user guide
Posted by Martijn Dashorst <ma...@gmail.com>.
On Mon, Apr 13, 2026 at 1:07 PM Andrea Del Bene <an...@gmail.com>
wrote:
> I've restored the site with an empty commit on asf-site 👍
>
You rock!
Again, apologies for causing extra work.
Martijn
Re: Proposal for a new Wicket website and user guide
Posted by Andrea Del Bene <an...@gmail.com>.
I've restored the site with an empty commit on asf-site 👍
On Mon, Apr 13, 2026 at 12:37 PM Andrea Del Bene <an...@gmail.com>
wrote:
> Hi Martijn,
>
> I've tried to full explain the what happened here with the Infra team:
> https://issues.apache.org/jira/browse/WICKET-7181
>
> Hope they could provide help.
>
> On Mon, Apr 13, 2026 at 11:18 AM Martijn Dashorst <
> martijn.dashorst@gmail.com> wrote:
>
>> It appears that there is no build step anymore?
>>
>> But I can't seem to find the build steps in the
>> github.com/apache/wicket-site repo, only an .asf.yaml file that doesn't
>> tell me anything.
>>
>> Martijn
>>
>>
>> On Mon, Apr 13, 2026 at 11:12 AM Martijn Dashorst <
>> martijn.dashorst@gmail.com> wrote:
>>
>> >
>> >
>> > On Mon, Apr 13, 2026 at 10:28 AM Andrea Del Bene <an...@gmail.com>
>> > wrote:
>> >
>> >> On Mon, Apr 13, 2026 at 7:02 AM Richard Eckart de Castilho <
>> >> rec@apache.org>
>> >> wrote:
>> >>
>> >> > Hi :)
>> >> >
>> >> > I was going to say I find the current site more professional (no
>> fancy
>> >> > font,
>> >> > unrelated imagery, flashy lights), but trying to access the current
>> >> site, I
>> >> > found it is completely broken :(
>> >> >
>> >> > https://wicket.apache.org/
>> >>
>> >>
>> >> I like the new site! However I'm not so sure about the font
>> '"Fraunces",
>> >> Georgia, serif', I find it a little too "cursive", but it's my personal
>> >> taste
>> >> About the current site, I've seen infra opened an issue because the
>> >> branch jekyll-site went missing and is used to generate site. As far
>> as I
>> >> remember we always used branch asf-site to serve
>> >> Wicket site, but I guess branch jekyll-site is the one to use in order
>> to
>> >> automatically generate site from jekyll project. Anyway, I
>> >> restored jekyll-site but we still have some problems.
>> >>
>> >
>> > Yeah, my bad: I wanted to push to github.com/dashorst/wicket-site, but
>> it
>> > pushed to origin.
>> >
>> > Apologies!
>> >
>> > Martijn
>> >
>> >
>>
>> --
>> Become a Wicket expert, learn from the best: http://wicketinaction.com
>>
>
>
> --
> Andrea Del Bene.
> Apache Wicket committer.
>
--
Andrea Del Bene.
Apache Wicket committer.
Re: Proposal for a new Wicket website and user guide
Posted by Andrea Del Bene <an...@gmail.com>.
Hi Martijn,
I've tried to full explain the what happened here with the Infra team:
https://issues.apache.org/jira/browse/WICKET-7181
Hope they could provide help.
On Mon, Apr 13, 2026 at 11:18 AM Martijn Dashorst <
martijn.dashorst@gmail.com> wrote:
> It appears that there is no build step anymore?
>
> But I can't seem to find the build steps in the
> github.com/apache/wicket-site repo, only an .asf.yaml file that doesn't
> tell me anything.
>
> Martijn
>
>
> On Mon, Apr 13, 2026 at 11:12 AM Martijn Dashorst <
> martijn.dashorst@gmail.com> wrote:
>
> >
> >
> > On Mon, Apr 13, 2026 at 10:28 AM Andrea Del Bene <an...@gmail.com>
> > wrote:
> >
> >> On Mon, Apr 13, 2026 at 7:02 AM Richard Eckart de Castilho <
> >> rec@apache.org>
> >> wrote:
> >>
> >> > Hi :)
> >> >
> >> > I was going to say I find the current site more professional (no fancy
> >> > font,
> >> > unrelated imagery, flashy lights), but trying to access the current
> >> site, I
> >> > found it is completely broken :(
> >> >
> >> > https://wicket.apache.org/
> >>
> >>
> >> I like the new site! However I'm not so sure about the font '"Fraunces",
> >> Georgia, serif', I find it a little too "cursive", but it's my personal
> >> taste
> >> About the current site, I've seen infra opened an issue because the
> >> branch jekyll-site went missing and is used to generate site. As far as
> I
> >> remember we always used branch asf-site to serve
> >> Wicket site, but I guess branch jekyll-site is the one to use in order
> to
> >> automatically generate site from jekyll project. Anyway, I
> >> restored jekyll-site but we still have some problems.
> >>
> >
> > Yeah, my bad: I wanted to push to github.com/dashorst/wicket-site, but
> it
> > pushed to origin.
> >
> > Apologies!
> >
> > Martijn
> >
> >
>
> --
> Become a Wicket expert, learn from the best: http://wicketinaction.com
>
--
Andrea Del Bene.
Apache Wicket committer.
Re: Proposal for a new Wicket website and user guide
Posted by Martijn Dashorst <ma...@gmail.com>.
It appears that there is no build step anymore?
But I can't seem to find the build steps in the
github.com/apache/wicket-site repo, only an .asf.yaml file that doesn't
tell me anything.
Martijn
On Mon, Apr 13, 2026 at 11:12 AM Martijn Dashorst <
martijn.dashorst@gmail.com> wrote:
>
>
> On Mon, Apr 13, 2026 at 10:28 AM Andrea Del Bene <an...@gmail.com>
> wrote:
>
>> On Mon, Apr 13, 2026 at 7:02 AM Richard Eckart de Castilho <
>> rec@apache.org>
>> wrote:
>>
>> > Hi :)
>> >
>> > I was going to say I find the current site more professional (no fancy
>> > font,
>> > unrelated imagery, flashy lights), but trying to access the current
>> site, I
>> > found it is completely broken :(
>> >
>> > https://wicket.apache.org/
>>
>>
>> I like the new site! However I'm not so sure about the font '"Fraunces",
>> Georgia, serif', I find it a little too "cursive", but it's my personal
>> taste
>> About the current site, I've seen infra opened an issue because the
>> branch jekyll-site went missing and is used to generate site. As far as I
>> remember we always used branch asf-site to serve
>> Wicket site, but I guess branch jekyll-site is the one to use in order to
>> automatically generate site from jekyll project. Anyway, I
>> restored jekyll-site but we still have some problems.
>>
>
> Yeah, my bad: I wanted to push to github.com/dashorst/wicket-site, but it
> pushed to origin.
>
> Apologies!
>
> Martijn
>
>
--
Become a Wicket expert, learn from the best: http://wicketinaction.com
Re: Proposal for a new Wicket website and user guide
Posted by Martijn Dashorst <ma...@gmail.com>.
On Mon, Apr 13, 2026 at 10:28 AM Andrea Del Bene <an...@gmail.com>
wrote:
> On Mon, Apr 13, 2026 at 7:02 AM Richard Eckart de Castilho <rec@apache.org
> >
> wrote:
>
> > Hi :)
> >
> > I was going to say I find the current site more professional (no fancy
> > font,
> > unrelated imagery, flashy lights), but trying to access the current
> site, I
> > found it is completely broken :(
> >
> > https://wicket.apache.org/
>
>
> I like the new site! However I'm not so sure about the font '"Fraunces",
> Georgia, serif', I find it a little too "cursive", but it's my personal
> taste
> About the current site, I've seen infra opened an issue because the
> branch jekyll-site went missing and is used to generate site. As far as I
> remember we always used branch asf-site to serve
> Wicket site, but I guess branch jekyll-site is the one to use in order to
> automatically generate site from jekyll project. Anyway, I
> restored jekyll-site but we still have some problems.
>
Yeah, my bad: I wanted to push to github.com/dashorst/wicket-site, but it
pushed to origin.
Apologies!
Martijn
Re: Proposal for a new Wicket website and user guide
Posted by Andrea Del Bene <an...@gmail.com>.
On Mon, Apr 13, 2026 at 7:02 AM Richard Eckart de Castilho <re...@apache.org>
wrote:
> Hi :)
>
> I was going to say I find the current site more professional (no fancy
> font,
> unrelated imagery, flashy lights), but trying to access the current site, I
> found it is completely broken :(
>
> https://wicket.apache.org/
I like the new site! However I'm not so sure about the font '"Fraunces",
Georgia, serif', I find it a little too "cursive", but it's my personal
taste
About the current site, I've seen infra opened an issue because the
branch jekyll-site went missing and is used to generate site. As far as I
remember we always used branch asf-site to serve
Wicket site, but I guess branch jekyll-site is the one to use in order to
automatically generate site from jekyll project. Anyway, I
restored jekyll-site but we still have some problems.
>
>
> Cheers,
>
> -- Richard
>
> > On 12. Apr 2026, at 22:35, Martijn Dashorst <ma...@gmail.com>
> 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
> > 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
>
>
--
Andrea Del Bene.
Apache Wicket committer.
Re: Proposal for a new Wicket website and user guide
Posted by Richard Eckart de Castilho <re...@apache.org>.
Hi :)
I was going to say I find the current site more professional (no fancy font,
unrelated imagery, flashy lights), but trying to access the current site, I
found it is completely broken :(
https://wicket.apache.org/
Cheers,
-- Richard
> On 12. Apr 2026, at 22:35, Martijn Dashorst <ma...@gmail.com> 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
> 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
Re: Proposal for a new Wicket website and user guide
Posted by Martin Grigorov <mg...@apache.org>.
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 <
martijn.dashorst@gmail.com> 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
>
Re: Proposal for a new Wicket website and user guide
Posted by Pedro Santos <pe...@gmail.com>.
Hi, I liked both the landing page and the structured doc.
Pedro Santos
On Sun, Apr 12, 2026 at 5:35 PM Martijn Dashorst <ma...@gmail.com>
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
> 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
>