<!channel> Hey folks, we’re about to release an updated and (hopefully) improved docs site, which will also include the WireMock.Net docs for the first time. If you could take a few minutes to have a look and give us some feedback that would be very much appreciated and will help make the docs more useful before we launch. Here’s a temporary version of the new site: https://new-2025.wiremock.org/docs/

• I am less keen on the non-fixed footer since when you currently scroll down the sidebar resizes. • Why does .net get a welcome, and Java doesn't? • Wouldn't it make more sense to have the GitHub link in the .net version link to: https://github.com/wiremock/WireMock.Net ? • Please provide a dark mode

The Admin API list of endpoints is a bit too small, the endpoint names get cut over multiple lines (first picture), it is more readable in the old version (2nd picture). But the links actually work now, which is a huge improvement!

@Mathieu eugh, not sure what’s happened there. Thanks for pointing this out!

1. notice the sidebar size

Ah I see, literally the title text 🙂

I noticed that too, I can't reach the

Admin API

link in the left bar unless I scroll the main content to the very bottom

Yep, that’s pretty awkward. Will add that to the list.

The search seemingly does nothing?

It works for me. What happens when you type in it and hit enter?

Nothing, and nothing in the console

Which browser are you using?

Latest chrome

Same here and it works fine. Any chance it could be getting ad blocked?

No, no ad blocks and nothing in the console.

Wonder what the difference could be then… Which OS are you running?

W11, up to date.

Thanks, will test on that when I can get my hands on a VM.

Ah, try toggling between java and .net a few times.

Aha, that breaks for me too

The search result content doesn't behave correctly when clicking a result

• It might be just me, but the callout top/bottom paddings seem too tall. • Breadcumbs: Documentation takes to the homepage, while it is docs that takes to the actual documentation. • Text Only as a code block language title seems unnecessary (if this is hideable) • The orange WireMock Cloud callouts look like a warning sign to me, rather than an encouragment for using it as an alternative.

All good points, thanks @Balog Tamás! I want to change the callouts, but was going to do that in a separate pass when we’ve had time to do a little bit of design.

The icon alignment also feels off .

Language specific WireMock docs have no sidebar (not sure if they should), e.g. https://new-2025.wiremock.org/docs/solutions/python/, and the solutions breadcrumb element takes to a non-existent page.

The .net References button is broken. It points to References rather than references.

@Simon Verhoeven you mean the link in the LH nav?

Working fine for me

That’s what was happening this morning for me, but I fixed it.

Then there's still something cached on your end since I first loaded the site when you did the ping here.

I have to run for now but I’ll try to find a way to flush the CDN cache when I return

very nice @Tom

Yeah, not sure why that’s so wide at the moment

The website doesn't look perfect on mobile but it is not the main consumer. I will try to experiment with the site in the next few days