docs: fix middleware formatting

Author: alukach

Makefile

@@ -1,4 +1,4 @@
-.PHONY: help test test-coverage test-fast lint format clean install dev-install
+.PHONY: help test test-coverage test-fast lint format clean install dev-install docs
 
 help: ## Show this help message
 	@echo "Available commands:"
@@ -71,3 +71,7 @@ ci: ## Run CI checks locally
 		--cov-fail-under=85 \
 		-v
 	@echo "✅ CI checks completed!"
+
+docs: ## Serve documentation locally
+	uv sync --extra docs
+	DYLD_FALLBACK_LIBRARY_PATH=/opt/homebrew/lib uv run mkdocs serve

docs/architecture/middleware-stack.md

@@ -8,59 +8,59 @@ Aside from the actual communication with the upstream STAC API, the majority of
 > [!IMPORTANT]
 > The order of middleware execution is **critical**. For example, `RemoveRootPathMiddleware` must run before `EnforceAuthMiddleware` so that authentication decisions are made on the correct path after root path removal.
 
-1. **[`CompressionMiddleware`][starlette_cramjam.middleware.CompressionMiddleware]**
+1.  **[`CompressionMiddleware`](https://github.com/developmentseed/starlette-cramjam)**
 
-   - Handles response compression when [`ENABLE_COMPRESSION`](configuration.md#enable_compression) is enabled
-   - Reduces response size for better performance
+    - Handles response compression when [`ENABLE_COMPRESSION`](configuration.md#enable_compression) is enabled
+    - Reduces response size for better performance
 
-2. **[`RemoveRootPathMiddleware`][stac_auth_proxy.middleware.RemoveRootPathMiddleware]**
+2.  **[`RemoveRootPathMiddleware`][stac_auth_proxy.middleware.RemoveRootPathMiddleware]**
 
-   - Removes the application root path from incoming requests
-   - Ensures requests are properly routed to upstream API
-   - Only active if [`ROOT_PATH`](configuration.md#root_path) is configured
+    - Removes the application root path from incoming requests
+    - Ensures requests are properly routed to upstream API
+    - Only active if [`ROOT_PATH`](configuration.md#root_path) is configured
 
-3. **[`ProcessLinksMiddleware`][stac_auth_proxy.middleware.ProcessLinksMiddleware]**
+3.  **[`ProcessLinksMiddleware`][stac_auth_proxy.middleware.ProcessLinksMiddleware]**
 
-   - Updates links in JSON responses to handle root path and upstream URL path differences
-   - Removes upstream URL path from links and adds root path if configured
-   - Only active if [`ROOT_PATH`](configuration.md#root_path) is set or `upstream_url.path != "/"`
+    - Updates links in JSON responses to handle root path and upstream URL path differences
+    - Removes upstream URL path from links and adds root path if configured
+    - Only active if [`ROOT_PATH`](configuration.md#root_path) is set or `upstream_url.path != "/"`
 
-4. **[`EnforceAuthMiddleware`][stac_auth_proxy.middleware.EnforceAuthMiddleware]**
+4.  **[`EnforceAuthMiddleware`][stac_auth_proxy.middleware.EnforceAuthMiddleware]**
 
-   - Handles authentication and authorization
-   - Configurable public/private endpoints via [`PUBLIC_ENDPOINTS`](configuration.md#public_endpoints) and [`PRIVATE_ENDPOINTS`](configuration.md#private_endpoints)
-   - OIDC integration via [`OIDC_DISCOVERY_INTERNAL_URL`](configuration.md#oidc_discovery_internal_url)
-   - JWT audience validation via [`ALLOWED_JWT_AUDIENCES`](configuration.md#allowed_jwt_audiences)
-   - Places auth token payload in request state
+    - Handles authentication and authorization
+    - Configurable public/private endpoints via [`PUBLIC_ENDPOINTS`](configuration.md#public_endpoints) and [`PRIVATE_ENDPOINTS`](configuration.md#private_endpoints)
+    - OIDC integration via [`OIDC_DISCOVERY_INTERNAL_URL`](configuration.md#oidc_discovery_internal_url)
+    - JWT audience validation via [`ALLOWED_JWT_AUDIENCES`](configuration.md#allowed_jwt_audiences)
+    - Places auth token payload in request state
 
-5. **[`AddProcessTimeHeaderMiddleware`][stac_auth_proxy.middleware.AddProcessTimeHeaderMiddleware]**
+5.  **[`AddProcessTimeHeaderMiddleware`][stac_auth_proxy.middleware.AddProcessTimeHeaderMiddleware]**
 
-   - Adds processing time headers to responses
-   - Useful for monitoring and debugging
+    - Adds processing time headers to responses
+    - Useful for monitoring and debugging
 
-6. **[`Cql2BuildFilterMiddleware`][stac_auth_proxy.middleware.Cql2BuildFilterMiddleware]**
+6.  **[`Cql2BuildFilterMiddleware`][stac_auth_proxy.middleware.Cql2BuildFilterMiddleware]**
 
-   - Builds CQL2 filters based on request context/state
-   - Places [CQL2 expression](http://developmentseed.org/cql2-rs/latest/python/#cql2.Expr) in request state
-   - Only active if [`ITEMS_FILTER_CLS`](configuration.md#items_filter_cls) or [`COLLECTIONS_FILTER_CLS`](configuration.md#collections_filter_cls) is configured
+    - Builds CQL2 filters based on request context/state
+    - Places [CQL2 expression](http://developmentseed.org/cql2-rs/latest/python/#cql2.Expr) in request state
+    - Only active if [`ITEMS_FILTER_CLS`](configuration.md#items_filter_cls) or [`COLLECTIONS_FILTER_CLS`](configuration.md#collections_filter_cls) is configured
 
-7. **[`Cql2RewriteLinksFilterMiddleware`][stac_auth_proxy.middleware.Cql2RewriteLinksFilterMiddleware]**
+7.  **[`Cql2RewriteLinksFilterMiddleware`][stac_auth_proxy.middleware.Cql2RewriteLinksFilterMiddleware]**
 
-   - Rewrites filter parameters in response links to remove applied filters
-   - Ensures links in responses show the original filter state
-   - Only active if filtering is enabled (see [`ITEMS_FILTER_CLS`](configuration.md#items_filter_cls) or [`COLLECTIONS_FILTER_CLS`](configuration.md#collections_filter_cls))
+    - Rewrites filter parameters in response links to remove applied filters
+    - Ensures links in responses show the original filter state
+    - Only active if filtering is enabled (see [`ITEMS_FILTER_CLS`](configuration.md#items_filter_cls) or [`COLLECTIONS_FILTER_CLS`](configuration.md#collections_filter_cls))
 
-8. **[`Cql2ApplyFilterQueryStringMiddleware`][stac_auth_proxy.middleware.Cql2ApplyFilterQueryStringMiddleware]**
+8.  **[`Cql2ApplyFilterQueryStringMiddleware`][stac_auth_proxy.middleware.Cql2ApplyFilterQueryStringMiddleware]**
 
-   - Retrieves [CQL2 expression](http://developmentseed.org/cql2-rs/latest/python/#cql2.Expr) from request state
-   - Augments `GET` requests with CQL2 filter by appending to querystring
-   - Only active if filtering is enabled (see [`ITEMS_FILTER_CLS`](configuration.md#items_filter_cls) or [`COLLECTIONS_FILTER_CLS`](configuration.md#collections_filter_cls))
+    - Retrieves [CQL2 expression](http://developmentseed.org/cql2-rs/latest/python/#cql2.Expr) from request state
+    - Augments `GET` requests with CQL2 filter by appending to querystring
+    - Only active if filtering is enabled (see [`ITEMS_FILTER_CLS`](configuration.md#items_filter_cls) or [`COLLECTIONS_FILTER_CLS`](configuration.md#collections_filter_cls))
 
-9. **[`Cql2ApplyFilterBodyMiddleware`][stac_auth_proxy.middleware.Cql2ApplyFilterBodyMiddleware]**
+9.  **[`Cql2ApplyFilterBodyMiddleware`][stac_auth_proxy.middleware.Cql2ApplyFilterBodyMiddleware]**
 
-   - Retrieves [CQL2 expression](http://developmentseed.org/cql2-rs/latest/python/#cql2.Expr) from request state
-   - Augments `POST`/`PUT`/`PATCH` requests with CQL2 filter by modifying body
-   - Only active if filtering is enabled (see [`ITEMS_FILTER_CLS`](configuration.md#items_filter_cls) or [`COLLECTIONS_FILTER_CLS`](configuration.md#collections_filter_cls))
+    - Retrieves [CQL2 expression](http://developmentseed.org/cql2-rs/latest/python/#cql2.Expr) from request state
+    - Augments `POST`/`PUT`/`PATCH` requests with CQL2 filter by modifying body
+    - Only active if filtering is enabled (see [`ITEMS_FILTER_CLS`](configuration.md#items_filter_cls) or [`COLLECTIONS_FILTER_CLS`](configuration.md#collections_filter_cls))
 
 10. **[`Cql2ValidateResponseBodyMiddleware`][stac_auth_proxy.middleware.Cql2ValidateResponseBodyMiddleware]**