docs: fix grammar and typos across the docs

- config.md: "all the file" → "all the files"; drop stray "using" in
  "enable HTTPS using for all the hostnames"; remove a duplicated
  "start a new shell" line.
- docker.md: "by the one contained your custom modules" →
  "with the one containing your custom modules"; add missing article
  in "run as a non-root user".
- extensions.md: "deeper dive to type juggling" → "into type juggling";
  "Forces to design" → "Forces you to design".
- known-issues.md: "fully binary" → "fully static binary".
- laravel.md: "explicitly the pass `--log-level` option" →
  "explicitly pass the `--log-level` option"; "you can use enable
  Mercure" → "you can enable Mercure".
- mercure.md: "must used to sign" → "must be used to sign";
  "tokens generated aerodynamically using with a trusted" →
  "generated dynamically using a trusted"; "library handled" →
  "library handles".
- metrics.md: add missing articles in "absolute path of worker file".
- static.md: add missing article before "`scratch` Docker image".
- worker.md: "number of request" → "number of requests".
- x-sendfile.md: replace mid-sentence period with comma so the
  preamble before the examples reads as one sentence.

Author: dunglas

docs/config.md

@@ -307,7 +307,7 @@ The `S` value of [the `variables_order` PHP directive](https://www.php.net/manua
 
 To load [additional PHP configuration files](https://www.php.net/manual/en/configuration.file.php#configuration.file.scan),
 the `PHP_INI_SCAN_DIR` environment variable can be used.
-When set, PHP will load all the file with the `.ini` extension present in the given directories.
+When set, PHP will load all the files with the `.ini` extension present in the given directories.
 
 You can also change the PHP configuration using the `php_ini` directive in the `Caddyfile`:
 
@@ -328,7 +328,7 @@ You can also change the PHP configuration using the `php_ini` directive in the `
 
 ### Disabling HTTPS
 
-By default, FrankenPHP will automatically enable HTTPS using for all the hostnames, including `localhost`.
+By default, FrankenPHP will automatically enable HTTPS for all the hostnames, including `localhost`.
 If you want to disable HTTPS (for example in a development environment), you can set the `SERVER_NAME` environment variable to `http://` or `:80`:
 
 Alternatively, you can use all other methods described in the [Caddy documentation](https://caddyserver.com/docs/automatic-https#activation).
@@ -446,5 +446,3 @@ Add-Content -Path $PROFILE -Value '. (Join-Path (Split-Path $PROFILE) "frankenph
 ```
 
 You will need to start a new shell for this setup to take effect.
-
-You will need to start a new shell for this setup to take effect.

docs/docker.md

@@ -87,7 +87,7 @@ RUN CGO_ENABLED=1 \
 
 FROM dunglas/frankenphp AS runner
 
-# Replace the official binary by the one contained your custom modules
+# Replace the official binary with the one containing your custom modules
 COPY --from=builder /usr/local/bin/frankenphp /usr/local/bin/frankenphp
 ```
 
@@ -154,7 +154,7 @@ volumes:
 
 ## Running as a Non-Root User
 
-FrankenPHP can run as non-root user in Docker.
+FrankenPHP can run as a non-root user in Docker.
 
 Here is a sample `Dockerfile` doing this:
 

docs/extensions.md

@@ -86,7 +86,7 @@ There are two important things to note here:
 - A directive comment `//export_php:function` defines the function signature in PHP. This is how the generator knows how to generate the PHP function with the right parameters and return type.
 - The function must return an `unsafe.Pointer`. FrankenPHP provides an API to help you with type juggling between C and Go.
 
-While the first point speaks for itself, the second may be harder to apprehend. Let's take a deeper dive to type juggling later in this guide.
+While the first point speaks for itself, the second may be harder to apprehend. Let's take a deeper dive into type juggling later in this guide.
 
 ### Generating the Extension
 
@@ -339,7 +339,7 @@ type UserStruct struct {
 - **Method-only interface** - All interactions must go through methods you define
 - **Better encapsulation** - Internal data structure is completely controlled by Go code
 - **Type safety** - No risk of PHP code corrupting internal state with wrong types
-- **Cleaner API** - Forces to design a proper public interface
+- **Cleaner API** - Forces you to design a proper public interface
 
 This approach provides better encapsulation and prevents PHP code from accidentally corrupting the internal state of your Go objects. All interactions with the object must go through the methods you explicitly define.
 

docs/known-issues.md

@@ -28,7 +28,7 @@ The [get_browser()](https://www.php.net/manual/en/function.get-browser.php) func
 
 ## Standalone Binary and Alpine-based Docker Images
 
-The fully binary and Alpine-based Docker images (`dunglas/frankenphp:*-alpine`) use [musl libc](https://musl.libc.org/) instead of [glibc and friends](https://www.etalabs.net/compare_libcs.html), to keep a smaller binary size.
+The fully static binary and Alpine-based Docker images (`dunglas/frankenphp:*-alpine`) use [musl libc](https://musl.libc.org/) instead of [glibc and friends](https://www.etalabs.net/compare_libcs.html), to keep a smaller binary size.
 This may lead to some compatibility issues.
 In particular, the glob flag `GLOB_BRACE` is [not available](https://www.php.net/manual/en/function.glob.php)
 

docs/laravel.md

@@ -80,7 +80,7 @@ The `octane:frankenphp` command can take the following options:
 - `--log-level`: Log messages at or above the specified log level, using the native Caddy logger
 
 > [!TIP]
-> To get structured JSON logs (useful when using log analytics solutions), explicitly the pass `--log-level` option.
+> To get structured JSON logs (useful when using log analytics solutions), explicitly pass the `--log-level` option.
 
 See also [how to use Mercure with Octane](#mercure-support).
 
@@ -183,7 +183,7 @@ FrankenPHP includes [Mercure support out of the box](mercure.md).
 
 If you are not using [Octane](#laravel-octane), see [the Mercure documentation entry](mercure.md).
 
-If you are using Octane, you can use enable Mercure support by adding the following lines to your `config/octane.php` file:
+If you are using Octane, you can enable Mercure support by adding the following lines to your `config/octane.php` file:
 
 ```php
 // config/octane.php

docs/mercure.md

@@ -107,19 +107,19 @@ $updateID = file_get_contents('https://localhost/.well-known/mercure', context:
 error_log("update $updateID published", 4);
 ```
 
-The key passed as parameter of the `mercure.publisher_jwt` option in the `Caddyfile` must used to sign the JWT token used in the `Authorization` header.
+The key passed as parameter of the `mercure.publisher_jwt` option in the `Caddyfile` must be used to sign the JWT token used in the `Authorization` header.
 
 The JWT must include a `mercure` claim with a `publish` permission for the topics you want to publish to.
 See [the Mercure documentation](https://mercure.rocks/spec#publishers) about authorization.
 
 To generate your own tokens, you can use [this jwt.io link](https://www.jwt.io/#token=eyJhbGciOiJIUzI1NiJ9.eyJtZXJjdXJlIjp7InB1Ymxpc2giOlsiKiJdfX0.PXwpfIGng6KObfZlcOXvcnWCJOWTFLtswGI5DZuWSK4),
-but for production apps, it's recommended to use short-lived tokens generated aerodynamically using with a trusted [JWT library](https://www.jwt.io/libraries?programming_language=php).
+but for production apps, it's recommended to use short-lived tokens generated dynamically using a trusted [JWT library](https://www.jwt.io/libraries?programming_language=php).
 
 ### Using Symfony Mercure
 
 Alternatively, you can use the [Symfony Mercure Component](https://symfony.com/components/Mercure), a standalone PHP library.
 
-This library handled the JWT generation, update publishing as well as cookie-based authorization for subscribers.
+This library handles the JWT generation, update publishing as well as cookie-based authorization for subscribers.
 
 First, install the library using Composer:
 

docs/metrics.md

@@ -22,4 +22,4 @@ When [Caddy metrics](https://caddyserver.com/docs/metrics) are enabled, FrankenP
 - `frankenphp_worker_restarts{worker="[worker_name]"}`: The number of times a worker has been deliberately restarted.
 - `frankenphp_worker_queue_depth{worker="[worker_name]"}`: The number of queued requests.
 
-For worker metrics, the `[worker_name]` placeholder is replaced by the worker name in the Caddyfile, otherwise absolute path of worker file will be used.
+For worker metrics, the `[worker_name]` placeholder is replaced by the worker name in the Caddyfile, otherwise the absolute path of the worker file will be used.

docs/static.md

@@ -10,7 +10,7 @@ it's possible to create a static or mostly static build of FrankenPHP thanks to
 
 With this method, a single, portable, binary will contain the PHP interpreter, the Caddy web server, and FrankenPHP!
 
-Fully static native executables require no dependencies at all and can even be run on [`scratch` Docker image](https://docs.docker.com/build/building/base-images/#create-a-minimal-base-image-using-scratch).
+Fully static native executables require no dependencies at all and can even be run on a [`scratch` Docker image](https://docs.docker.com/build/building/base-images/#create-a-minimal-base-image-using-scratch).
 However, they can't load dynamic PHP extensions (such as Xdebug) and have some limitations because they are using the musl libc.
 
 Mostly static binaries only require `glibc` and can load dynamic extensions.

docs/worker.md

@@ -120,7 +120,7 @@ docker run \
 As PHP was not originally designed for long-running processes, there are still many libraries and legacy codes that leak memory.
 A workaround to using this type of code in worker mode is to restart the worker script after processing a certain number of requests:
 
-The previous worker snippet allows configuring a maximum number of request to handle by setting an environment variable named `MAX_REQUESTS`.
+The previous worker snippet allows configuring a maximum number of requests to handle by setting an environment variable named `MAX_REQUESTS`.
 
 ### Restart Workers Manually
 

docs/x-sendfile.md

@@ -20,7 +20,7 @@ containing the path of the file to be served. FrankenPHP takes care of the rest.
 
 This feature is known as **`X-Sendfile`** for Apache, and **`X-Accel-Redirect`** for NGINX.
 
-In the following examples, we assume that the document root of the project is the `public/` directory.
+In the following examples, we assume that the document root of the project is the `public/` directory,
 and that we want to use PHP to serve files stored outside the `public/` directory,
 from a directory named `private-files/`.