docs: remove version from API reference title, add OpenAPI to README

Strip v1.0.0 from the auto-generated api-reference.md title via the
generation script. Fix TOC generation by exporting the TOC env var.
Add built-in API documentation (OpenAPI/Swagger UI/ReDoc) to the
README "Why" section.

Author: millerjp

README.md

@@ -51,6 +51,7 @@ Unlike Confluent Schema Registry, which uses Kafka itself (a special `_schemas`
 - **Enterprise Security** -- LDAP, OIDC, mTLS, API keys, JWT, and RBAC out of the box
 - **Cloud Native** -- designed for Kubernetes with health checks, Prometheus metrics, and graceful shutdown
 - **Multi-Datacenter** -- active-active deployments with Cassandra's native cross-DC replication
+- **Built-in API Documentation** -- OpenAPI spec with Swagger UI and ReDoc, always in sync with the codebase
 
 ## Feature Comparison
 

docs/api-reference.md

@@ -2,8 +2,7 @@
 <!-- Do not edit manually. Regenerate with: make docs-api -->
 
 
-# AxonOps Schema Registry v1.0.0
-
+# AxonOps Schema Registry
 AxonOps Schema Registry is a drop-in replacement for the Confluent Schema Registry,
 providing full API compatibility with extensions for enterprise security and
 multi-backend storage. It supports **Avro**, **Protobuf**, and **JSON Schema**
@@ -12,7 +11,7 @@ formats for schema management.
 
 ## Contents
 
-- [AxonOps Schema Registry v1.0.0](#axonops-schema-registry-v100)
+- [AxonOps Schema Registry](#axonops-schema-registry)
   - [Key Concepts](#key-concepts)
   - [Content Types](#content-types)
   - [Error Handling](#error-handling)

scripts/generate-api-docs.sh

@@ -82,6 +82,9 @@ perl -0777 -pe '
     # Remove stray HTML break tags
     s|<br\s*/?>||g;
 
+    # Strip version suffix from the title heading (e.g. "v1.0.0")
+    s/^(# .+?) v\d+\.\d+\.\d+\s*$/$1/gm;
+
     # Collapse runs of 3+ blank lines to 2
     s/\n{4,}/\n\n\n/g;
 ' "$TMPFILE" > "$TMPFILE2"
@@ -113,6 +116,7 @@ generate_toc() {
 }
 
 TOC="$(generate_toc "$TMPFILE2")"
+export TOC
 
 # ── Assemble final output ─────────────────────────────────────────────
 #