# Octopus Deploy Platform Hub — Knowledge Base

Practical guidance for working with Octopus Deploy's Platform Hub, learned from building the PlatformHub-Demo project (a mock 30-microservice FinTech marketplace). This is a thin index — detail lives in `platformhub/`.

## Topics

- [Architecture Overview](platformhub/architecture.md) — How Platform Hub fits together: Git repo, OCL files, spaces, publishing
- [OCL Syntax Reference](platformhub/ocl-syntax.md) — Complete OCL format guide with examples for process templates
- [Process Template Patterns](platformhub/process-template-patterns.md) — Proven patterns for different deployment types (Go, Python, Node.js, Payment, Database)
- [Gotchas and Troubleshooting](platformhub/gotchas.md) — Every error we hit and how to fix it
- [API Reference](platformhub/api-reference.md) — What can and cannot be done via API vs UI