Clearer structure on overview and advanced page.

Author: pantierra

docs/index.md

@@ -1,65 +1,28 @@
 ---
-title: "eoAPI Kubernetes Documentation"
-description: "Technical documentation for deploying and operating eoAPI on Kubernetes clusters"
+title: "eoAPI Kubernetes"
+description: "Production-ready Kubernetes deployment"
 external_links:
-  - name: "Main eoapi Repository"
-    url: "https://github.com/developmentseed/eoapi"
   - name: "eoapi-k8s Repository"
     url: "https://github.com/developmentseed/eoapi-k8s"
 ---
 
-# eoAPI Kubernetes Documentation
+# eoAPI Kubernetes
 
-Technical documentation for deploying and operating eoAPI on Kubernetes clusters.
+Production-ready Kubernetes deployment for eoAPI.
 
-## Architecture
+The source code is maintained in the [eoapi-k8s repository](https://github.com/developmentseed/eoapi-k8s). Contributions are welcome!
 
-When deployed with default settings, eoAPI provides:
+## Kubernetes Architecture
 
-- High-availability PostgreSQL cluster (via PostgreSQL Operator)
-- Load balancer with path-based routing:
-    - `/stac` → STAC API
-    - `/raster` → TiTiler raster API
-    - `/vector` → TiPG vector API
-    - `/browser` → STAC Browser
-    - `/` → Documentation server
-- Horizontal pod autoscaling based on CPU or request rate metrics
-- Persistent storage with dynamic volume provisioning
-- TLS termination and certificate management
-- Health checks at `/stac/_mgmt/ping`, `/raster/healthz`, `/vector/healthz`
-
-## Quick Start
-
-Please refer to our [quick start guide](./quick-start.md)
-
-## Installation
-
-1. Set up a Kubernetes cluster using one of the cloud provider guides
-2. Install the PostgreSQL Operator dependency
-2. Configure your deployment using the [Configuration Options](./configuration.md)
-3. Deploy using [Helm Installation](./helm-install.md) instructions
-4. Set up monitoring with [Autoscaling & Monitoring](./autoscaling.md)
+This deployment provides:
 
-## Documentation
-
-### Cloud Provider Guides
-- **[AWS EKS Setup](./aws-eks.md)** - Complete EKS cluster setup with OIDC, node autoscaling, EBS CSI, and NGINX ingress
-- **[GCP GKE Setup](./gcp-gke.md)** - GKE cluster creation with CSI driver, NGINX ingress, and cert-manager
-- **[Azure AKS Setup](./azure.md)** - Azure configuration with managed PostgreSQL, Key Vault integration, and Workload Identity
-
-### Installation & Configuration
-- **[Configuration Options](./configuration.md)** - Complete reference for Helm values, database types, ingress setup, and service configuration
-- **[Manual Helm Installation](./helm-install.md)** - Step-by-step Helm deployment process with custom configurations
-- **[Unified Ingress Configuration](./unified-ingress.md)** - NGINX and Traefik ingress setup with TLS and cert-manager integration
-
-### Database Management
-- **[Data Management](./manage-data.md)** - Loading STAC collections and items into PostgreSQL using pypgstac
-
-### Operations & Monitoring
-- **[Autoscaling & Monitoring](./autoscaling.md)** - HPA setup with custom metrics, Grafana dashboards, Prometheus configuration, and load testing
+- Path-based ingress routing (`/stac`, `/raster`, `/vector`, `/browser`, ..)
+- A PostgreSQL cluster (via PostgreSQL Operator)
+- TLS termination and certificate management
+- Persistent storage with dynamic volume provisioning
+- Horizontal pod autoscaling with custom metrics
+- Built-in health checks and monitoring at `/stac/_mgmt/ping`, `/raster/healthz`, `/vector/healthz`
 
-### Advanced Features
-- **[STAC Auth Proxy Integration](./stac-auth-proxy.md)** - Service-specific ingress control for authenticated STAC access
+## Getting Started
 
-### Development & Release
-- **[Release Workflow](./release.md)** - Chart versioning, GitHub releases, and Helm repository publishing process
+Ready to deploy? Start with our [Quick Start guide](./quick-start.md) for fast installation, or explore the full documentation below for production deployments.

docs/release.md

@@ -10,7 +10,7 @@ external_links:
     url: "https://helm.sh/docs/chart_best_practices/"
 ---
 
-### Release Workflow
+# Release Workflow
 
 1. PRs that include changes in the `charts/<eoapi> || <eoapi-support> || <postgrescluster>` charts are manually required to consider
 whether their changes are major, minor or patch (in terms of semantic versioning) and bump the appropriate

docs/stac-auth-proxy.md

@@ -1,5 +1,5 @@
 ---
-title: "STAC Auth Proxy Integration"
+title: "STAC Auth Proxy"
 description: "Service-specific ingress control for authenticated STAC access"
 external_links:
   - name: "eoapi-k8s Repository"
@@ -8,7 +8,7 @@ external_links:
     url: "https://github.com/developmentseed/stac-auth-proxy"
 ---
 
-# STAC Auth Proxy Integration with eoAPI-K8S
+# STAC Auth Proxy
 
 ## Solution Overview
 

mkdocs.yml

@@ -23,7 +23,7 @@ docs_dir: docs
 site_dir: site
 
 nav:
-  - Overview: index.md
+  - Home: index.md
   - Quick Start: quick-start.md
   - Installation:
       - Helm Installation: helm-install.md
@@ -36,8 +36,9 @@ nav:
   - Operations:
       - Data Management: manage-data.md
       - Autoscaling & Monitoring: autoscaling.md
-  - Advanced:
+  - Authentication:
       - STAC Auth Proxy: stac-auth-proxy.md
+  - Contributing:
       - Release Workflow: release.md
 
 markdown_extensions: