Summary
The testing documentation (docs/contributing/testing-validation.md) references Terratest (Go-based) with go test examples, but the actual test implementation uses native terraform test with .tftest.hcl files. This discrepancy confuses contributors and misrepresents the testing approach.
Wave 0 — Foundation: This issue must merge before #145 so the test policy document references accurate frameworks.
Background
OSSF Passing Badge Criteria:
Current State:
docs/contributing/testing-validation.md (306 lines) references Terratest and go test
- Actual tests use native
terraform test with .tftest.hcl files
- 15 components have tests following the native terraform test pattern
- No Go files or Terratest dependencies exist in the repository
Acceptance Criteria
Implementation Guidance
Update docs/contributing/testing-validation.md to:
- Replace Terratest section with native terraform test section
- Include example from
src/000-cloud/000-resource-group/terraform/tests/
- Document
npm run tf-test and npm run tf-test-all commands
- Verify JavaScript testing section references vitest correctly
- Add or update Rust testing section with
cargo test patterns
Reference the actual test files in the repository for accurate examples.
Summary
The testing documentation (
docs/contributing/testing-validation.md) references Terratest (Go-based) withgo testexamples, but the actual test implementation uses nativeterraform testwith.tftest.hclfiles. This discrepancy confuses contributors and misrepresents the testing approach.Background
OSSF Passing Badge Criteria:
documentation_basics([Action Needed] This repo is inactive #1): PASS — but inaccurate documentation weakens evidence qualitytest_policy(chore(deps)(deps): bump actions/upload-artifact from 2848b2cda0e5190984587ec6bb1f36730ca78d50 to 330a01c490aca151604b8cf639adc76d48f6c5d4 #38): supported by accurate testing documentationCurrent State:
docs/contributing/testing-validation.md(306 lines) references Terratest andgo testterraform testwith.tftest.hclfilesAcceptance Criteria
go testexamples removed from testing-validation.mdterraform testpatterns documented with.tftest.hclexamples000-resource-group)Implementation Guidance
Update
docs/contributing/testing-validation.mdto:src/000-cloud/000-resource-group/terraform/tests/npm run tf-testandnpm run tf-test-allcommandscargo testpatternsReference the actual test files in the repository for accurate examples.