Docs
Internal-style documentation.
The same kind of pages you'd expect to find on a company's internal wiki — architecture, decisions and their reasoning, runbooks, tooling notes. Written as the work happens, kept honest about trade-offs.
Architecture
Architecture
High and low level designs, component breakdowns, how the pieces fit together.
-
Site infrastructure HLD
How harvtech.co.uk fits together end to end — platform layer, application stacks, edge, identity, CI/CD.
-
Azure data-platform HLD
Lakehouse-style data platform alongside the main site — ADLS Gen2, Cosmos DB, Data Factory, Databricks. Built cheap to demonstrate the IaC patterns from prior real-world experience.
Decisions
Decisions
Architecture decision records — what we chose, what we rejected, and why.
-
Front Door Standard, not Premium
Why we chose Standard SKU even though Premium would close a Critical security finding.
-
Platform RG separated from application resources
Why Terraform state and shared identity live in their own resource group rather than alongside the site.
-
Positioning — well-architected Azure landing zones
Walking back the generic-cloud framing in favour of a specific Azure landing-zone narrative, with AI as one of several modern workloads.
-
"Cloud" not "Azure" in the headline
Why the public-facing positioning was originally broader than the day-job stack.
Superseded -
Snyk IaC dropped, Snyk Open Source kept
Why the pipeline runs Snyk for npm dependency CVEs but not for Terraform misconfig.
How-to
How-to
Operational runbooks and step-by-step guides.
Tools
Tools
Tooling choices and rationale.
No docs in this category yet.