V1 documentation was easier to understand. This tutorial (https://caddyserver.com/v1/tutorial/caddyfile) had all the information I needed to run my site.
V2 documentation introduces complexity too early (JSON config, API) and reads more like a manual instead of a tutorial. There should be sample Caddyfiles for common use cases, like the ones here (GitHub - caddyserver/examples: OBSOLETE. This repo was for Caddy v1. For v2 and newer, see our forum's wiki category.).
My use case is running a PHP web server with CORS enabled. The v1 cors plugin syntax is easier to read:
cors / {website}
than v2, which is:
headers / {
Access-Control-Allow-Origin {website}
-Server
}
This also applies to the ipfilter plugin. I prefer shorter syntax to address these features.
I am running a few sites on v1, and would like to have access to the documentation in the future. The v1 website says it will go away soon. Why? Unless there are security implications, v1 shouldn’t be marked as obsolete. I would like to continue working with v1.