Merge pull request #71 from barbacane-dev/docs/seo-improvements

docs(seo): rewrite top-impression page titles, fix AWX/Makefile search noise

Author: ndreno

docs/SUMMARY.md

@@ -4,10 +4,10 @@
 
 # User Guide
 
-- [Getting Started](guide/getting-started.md)
-- [Spec Configuration](guide/spec-configuration.md)
-- [Dispatchers](guide/dispatchers.md)
-- [Middlewares](guide/middlewares/index.md)
+- [Getting started](guide/getting-started.md)
+- [Spec configuration](guide/spec-configuration.md)
+- [Dispatchers (request routing)](guide/dispatchers.md)
+- [Middlewares (auth, rate limit, AI)](guide/middlewares/index.md)
   - [Authentication](guide/middlewares/authentication.md)
   - [Authorization](guide/middlewares/authorization.md)
   - [Traffic Control](guide/middlewares/traffic-control.md)
@@ -17,21 +17,21 @@
   - [AI Gateway](guide/middlewares/ai-gateway.md)
 - [Secrets](guide/secrets.md)
 - [Observability](guide/observability.md)
-- [Control Plane](guide/control-plane.md)
+- [Control plane (REST API)](guide/control-plane.md)
 - [Web UI](guide/web-ui.md)
 - [MCP Server](guide/mcp.md)
 - [Linting with Vacuum](guide/vacuum.md)
 - [FIPS 140-3 Compliance](guide/fips.md)
 
 # Reference
 
-- [CLI Reference](reference/cli.md)
+- [CLI reference](reference/cli.md)
 - [Spec Extensions](reference/extensions.md)
 - [Artifact Format](reference/artifact.md)
 - [Reserved Endpoints](reference/endpoints.md)
 
 # Contributing
 
 - [Architecture](contributing/architecture.md)
-- [Development Guide](contributing/development.md)
-- [Plugin Development](contributing/plugins.md)
+- [Development setup](contributing/development.md)
+- [WASM plugin development](contributing/plugins.md)

docs/contributing/development.md

@@ -1,4 +1,4 @@
-# Development Guide
+# Development setup
 
 This guide helps you set up a development environment for contributing to Barbacane.
 

docs/contributing/plugins.md

@@ -1,4 +1,4 @@
-# Plugin Development Guide
+# WASM plugin development
 
 This guide explains how to create WASM plugins for Barbacane.
 

docs/guide/control-plane.md

@@ -1,4 +1,4 @@
-# Control Plane
+# Control plane
 
 The Barbacane Control Plane provides a REST API for managing API specifications, plugins, and compiled artifacts. It enables centralized management of your API gateway configuration with PostgreSQL-backed storage and async compilation.
 
@@ -319,9 +319,9 @@ The control plane notifies all connected data planes, which download the new art
 
 ## Web UI
 
-The control plane includes a web-based management interface at `http://localhost:5173` (when running the UI development server).
+The control plane includes a web-based management interface at `http://localhost:5173` (once the dev server is running locally).
 
-### Running the UI
+### Starting the web UI dev server
 
 ```bash
 # Using Makefile

docs/guide/getting-started.md

@@ -1,4 +1,4 @@
-# Getting Started
+# Getting started
 
 This guide walks you through creating your first Barbacane-powered API gateway.
 

docs/guide/spec-configuration.md

@@ -1,4 +1,4 @@
-# Spec Configuration
+# Spec configuration
 
 Barbacane extends OpenAPI and AsyncAPI specs with custom `x-barbacane-*` extensions. These tell the gateway how to route requests, apply middleware, and connect to backends.
 

docs/reference/cli.md

@@ -1,4 +1,4 @@
-# CLI Reference
+# CLI reference
 
 Barbacane provides two command-line tools:
 - **barbacane** - Data plane (gateway) for compiling specs and serving traffic