[unfocussed_mike]

I think the title is silly, but the article is reasonable.

I have this same problem with the documentation for the (really absolutely incredibly useful) Caddy webserver.

Caddy itself is extremely powerful and you can do a lot with the configuration. But finding how you do that requires exploring the documentation as if it were a hypertext adventure. Some of this comes from the documentation effort being repeated for the significantly different 2.x version, but it's also a deliberate choice.

[corobo]

Caddy's 2.x documentation almost put me off Caddy haha

Try to find how to use the `ask` function to verify whether a requested domain should get a certificate provisioned.

If you can do it without having to manually sift through the docs and then give up and tackle it with trial and error I'll.. well I'll be put in my place, but it proper tripped me up when I needed it

[unfocussed_mike]

I had a bit of a battle to find out how to do a couple of things, but the weirdest challenge was to find out how to force it to refresh a Let's Encrypt certificate!

I absolutely love the performance, and now I have it working, I am super-pleased with the simplicity of the configuration for e.g. a nuxt static site with a PHP graphql server.

But it really was a bit mindbending.