Could you be more specific about these complaints? What examples don't work? We can't work on improving the docs if we don't get specific and actionable feedback. The docs are found at
https://github.com/caddyserver/website if you want to propose any changes. You can also come ask for help on the forums
https://caddy.community if you can't find what you're looking for.