Apply suggestions from code review

Co-authored-by: Kévin Dunglas <kevin@dunglas.fr>

Author: henderkes

caddy/frankenphp/Caddyfile

@@ -1,7 +1,7 @@
-# The Caddyfile is an easy way to configure your Caddy web server.
+# The Caddyfile is an easy way to configure FrankenPHP and the Caddy web server.
 #
-# https://caddyserver.com/docs/caddyfile
 # https://frankenphp.dev/docs/config
+# https://caddyserver.com/docs/caddyfile
 
 {
 	{$CADDY_GLOBAL_OPTIONS}

docs/config.md

@@ -8,13 +8,13 @@ You can specify a custom path with the `-c` or `--config` option.
 
 PHP itself can be configured [using a `php.ini` file](https://www.php.net/manual/en/configuration.file.php).
 
-The PHP interpreter will look in the following locations:
+Depending on your installation method, the PHP interpreter will look for configuration files in locations described above.
 
-Docker:
+## Docker
 
-- php.ini: `/usr/local/etc/php/php.ini` No php.ini is provided by default.
+- `php.ini`: `/usr/local/etc/php/php.ini` (no `php.ini` is provided by default)
 - additional configuration files: `/usr/local/etc/php/conf.d/*.ini`
-- php extensions: `/usr/local/lib/php/extensions/no-debug-zts-<YYYYMMDD>/`
+- PHP extensions: `/usr/local/lib/php/extensions/no-debug-zts-<YYYYMMDD>/`
 - You should copy an official template provided by the PHP project:
 
 ```dockerfile
@@ -33,17 +33,17 @@ dev.Dockerfile:
 - additional configuration files: `/etc/frankenphp/php.d/*.ini`
 - php extensions: `/usr/lib/frankenphp/modules/`
 
-FrankenPHP installation (.rpm or .deb):
+## RPM and Debian packages
 
-- php.ini: `/etc/frankenphp/php.ini` A php.ini file with production presets is provided by default.
+- `php.ini`: `/etc/frankenphp/php.ini` (a `php.ini` file with production presets is provided by default)
 - additional configuration files: `/etc/frankenphp/php.d/*.ini`
-- php extensions: `/usr/lib/frankenphp/modules/`
+- PHP extensions: `/usr/lib/frankenphp/modules/`
 
-Static binary:
+## Static binary
 
-- php.ini: The directory in which `frankenphp run` or `frankenphp php-server` is executed, then `/etc/frankenphp/php.ini`
+- `php.ini`: The directory in which `frankenphp run` or `frankenphp php-server` is executed, then `/etc/frankenphp/php.ini`
 - additional configuration files: `/etc/frankenphp/php.d/*.ini`
-- php extensions: cannot be loaded
+- PHP extensions: cannot be loaded, bundle them in the binary itself
 - copy one of `php.ini-production` or `php.ini-development` provided [in the PHP sources](https://github.com/php/php-src/).
 
 ## Caddyfile Config

package/Caddyfile

@@ -1,7 +1,7 @@
-# The Caddyfile is an easy way to configure your Caddy web server.
+# The Caddyfile is an easy way to configure FrankenPHP and the Caddy web server.
 #
-# https://caddyserver.com/docs/caddyfile
 # https://frankenphp.dev/docs/config
+# https://caddyserver.com/docs/caddyfile
 {
 	{$CADDY_GLOBAL_OPTIONS}