Existing Docs
Root-level docs/*.md and docs/*.html files remain in the repository during the Starlight transition. Use the Starlight pages first for the current env-dataops operating model; use the older docs below as deeper reference material after checking their freshness notes.
| File | Use For | Freshness Note |
|---|---|---|
| data-platform-auth-and-data-flow.html | visual auth, data, and deployment flows | Useful, but this Starlight site now has the current narrative entry points. |
| kyuubi-clusters.md | Kyuubi warehouse tuning and cost attribution context | Contains legacy test-dataops-era URLs; verify with terraform/kyuubi/env/<env>. |
| polaris-catalog-architecture.md | Polaris architecture background | Contains older test-dataops examples; verify with terraform/polaris/env/<env>. |
| spark-cost-tracking.md | cost tables and attribution model | Still useful; verify current env coverage against terraform/kyuubi/env/<env>. |
| iceberg-monitoring-architecture.md | Iceberg table health monitoring | Still useful; all env enablement is recorded under DL-474. |
| snowflake-catalog-integration.md | Snowflake Glue and Polaris catalog details | Useful, but naming examples may predate LH_GLUE_<ENV> and LH_POLARIS_<ENV>. |
| snowpack-pyiceberg-health.md | Snowpack health integration | Cross-repo behavior; check Snowpack before making changes. |
| Deployment-Docs.md | older deployment notes | Treat as legacy until checked against current workflows. |
| quickstart.md | older quickstart notes | Treat as legacy until checked against current workflows. |
| runbook.md | operational snippets | Useful, but verify account and host names before use. |
| mwaa-iam-role-deployment.md | MWAA role deployment | Separate from env-dataops EKS runtime services. |
| README_S3_RENAMING.md | S3 rename notes | Historical reference. |
Freshness Rule
When an older doc disagrees with current code, prefer the current code, then the newest implementation record. Later implementation records can intentionally override earlier design docs.
Checked Against
- Root-level
docs/inventory onorigin/main. implementations/2026-05-26-dl-388-terraform-cutover-progress.md.implementations/2026-05-28-dl-474-iceberg-table-health-all-envs-progress.md.