// the find
antonbabenko/terraform-best-practices
Terraform Best Practices free ebook translated into 🇬🇧🇦🇪🇧🇦🇧🇷🇫🇷🇬🇪🇩🇪🇬🇷🇮🇱🇮🇳🇮🇩🇮🇹🇯🇵🇰🇷🇵🇱🇷🇴🇨🇳🇪🇸🇹🇷🇺🇦🇵🇰
A free ebook by Anton Babenko (prominent Terraform community figure, author of many widely-used AWS modules) covering opinionated conventions for structuring Terraform projects at small, medium, and large scale. It's aimed at teams moving past 'it works' toward something maintainable over years, with concrete guidance on module composition, naming, and code structure.
The small/medium/large project size framing is genuinely useful — most guides treat Terraform as one-size-fits-all, which is why teams over-engineer simple setups. The working code examples in examples/ show the actual directory layout and module wiring, not just diagrams. Anton maintains a lot of real production Terraform, so the advice is grounded in actual pain rather than theory. 20+ language translations with active maintenance suggests the community finds it worth keeping alive.
The book was started in 2018 and, despite being updated for Terraform 1.0, it predates several workflow shifts — notably the rise of OpenTofu as a drop-in fork, which matters if you care about license implications. The 'not-best-practices' section appears to be a stub (sub-menu.md only), which is where half the learning actually happens. There are no examples covering Terraform with CI/CD guardrails, drift detection, or state locking strategies, which are the parts that actually hurt teams in production. The GitBook hosting means if that service degrades or paywalls something, the book's availability is not fully self-contained.