Add complete user-facing documentation and remove dev-focused content

- Add example documentation:
  - HTTP GraphQL examples with schema and queries
  - WebSocket subscriptions with client integration
  - Django Channels complete setup guide
  - Advanced patterns for production optimization

- Add reference documentation:
  - Complete API reference for all functions
  - Comprehensive configuration guide
  - Troubleshooting guide for common issues

- Update existing documentation:
  - Remove testing and deployment guides (dev-focused)
  - Update contributing.md to reference justfile and uv
  - Fix broken anchor links in examples index
  - Remove architecture reference from navigation

All documentation now builds without warnings.

Author: SmileyChris

docs/about/contributing.md

@@ -26,11 +26,11 @@ cd graphql-sqlcommenter
 Using uv (recommended):
 
 ```bash
-# Install dependencies
-uv pip install -e ".[dev,docs]"
+# Install dependencies (syncs from pyproject.toml)
+uv sync
 
 # Run tests to verify setup
-pytest tests/
+uv run pytest tests/
 ```
 
 ### 3. Create a Branch
@@ -43,46 +43,59 @@ git checkout -b fix/issue-description
 
 ## Development Workflow
 
+We use [uv](https://docs.astral.sh/uv/) for fast Python package management and [just](https://just.systems/) for common development tasks. Install both via your package manager.
+
+### List Available Commands
+
+```bash
+# See all available commands
+just
+```
+
 ### Running Tests
 
 ```bash
-# Run all tests
+# Run all tests with coverage
+just test
+
+# Or run pytest directly:
 pytest tests/ -v
 
 # Run specific test file
 pytest tests/test_middleware.py -v
-
-# Run with coverage
-pytest tests/ --cov=graphql_sqlcommenter --cov-report=html
-
-# View coverage report
-open htmlcov/index.html
 ```
 
+Coverage reports are generated in `htmlcov/index.html`.
+
 ### Code Style
 
-We follow PEP 8 and use type hints where appropriate.
+We follow PEP 8 and use Ruff for linting/formatting, with mypy for type checking.
 
 ```bash
-# Format code (if using black)
-black graphql_sqlcommenter/ tests/
+# Format code
+just format
+
+# Check code (lint and type check)
+just lint
 
-# Check types
-uv run mypy graphql_sqlcommenter
+# Or run tools directly:
+uv run ruff format graphql_sqlcommenter/ tests/
+uv run ruff check graphql_sqlcommenter/ tests/
+uv run mypy graphql_sqlcommenter/
 ```
 
 ### Documentation
 
 Build documentation locally:
 
 ```bash
-# Install docs dependencies
-uv pip install -e ".[docs]"
+# Serve docs locally (with live reload)
+just docs
 
-# Serve docs locally
-mkdocs serve
+# Or run mkdocs directly:
+uv run mkdocs serve
 
-# Open http://127.0.0.1:8000
+# Open http://127.0.0.1:8800 (just docs) or http://127.0.0.1:8000 (mkdocs serve)
 ```
 
 ## Making Changes

docs/about/project-summary.md

@@ -24,9 +24,7 @@ graphql-sqlcommenter/
 │   │   └── configuration.md
 │   ├── guides/
 │   │   ├── implementation-guide.md
-│   │   ├── subscription-guide.md
-│   │   ├── testing.md
-│   │   └── deployment.md
+│   │   └── subscription-guide.md
 │   ├── examples/
 │   ├── reference/
 │   └── about/
@@ -301,8 +299,6 @@ SQLCOMMENTER_GRAPHQL_PATHS = ['/graphql']     # GraphQL endpoints
 ### Guides
 - [Implementation Guide](../guides/implementation-guide.md) - Comprehensive setup
 - [Subscription Guide](../guides/subscription-guide.md) - WebSocket/Channels
-- [Testing Guide](../guides/testing.md) - Test strategies
-- [Deployment Guide](../guides/deployment.md) - Production rollout
 
 ### Examples
 - [HTTP GraphQL](../examples/http-graphql.md) - Standard examples
@@ -313,7 +309,6 @@ SQLCOMMENTER_GRAPHQL_PATHS = ['/graphql']     # GraphQL endpoints
 ### Reference
 - [API Reference](../reference/api.md) - API documentation
 - [Configuration](../reference/configuration.md) - Settings reference
-- [Architecture](../reference/architecture.md) - Technical details
 - [Troubleshooting](../reference/troubleshooting.md) - Common issues
 
 ## Production Deployment
@@ -387,7 +382,7 @@ SQLCOMMENTER_WITH_GRAPHQL = os.getenv('ENABLE_GRAPHQL_COMMENTS', 'false') == 'tr
 ### For Users
 1. [Install the package](../getting-started/installation.md)
 2. [Follow quick start](../getting-started/quickstart.md)
-3. [Deploy to staging](../guides/deployment.md)
+3. [Configure your application](../getting-started/configuration.md)
 4. [Monitor in PlanetScale](../guides/implementation-guide.md)
 
 ### For Contributors