| name | docs-drift |
| description | Validates confluentinc/terraform-provider-confluent's docs/ (resources, data-sources, guides) and examples against the actual Go schema definitions to catch stale references to deprecated or renamed resources/attributes, wrong/missing/extra attributes vs. schema, typos, broken links, and example .tf blocks that no longer validate against the current provider. Use when asked to check for documentation drift, validate provider docs/examples, or audit resource/data-source docs for staleness. Read-only by default — only edits a file when explicitly asked to fix something. |
Docs Drift — confluentinc/terraform-provider-confluent
docs/ (resources/, data-sources/, guides/) was originally generated by tfplugindocs, but that's not wired into CI or the build today — it's effectively hand-maintained now, so drift is structurally possible even where things currently look fine. Ground truth lives in internal/provider/resource_*.go / data_source_*.go schema maps and internal/provider/provider.go's ResourcesMap/DataSourcesMap.
1. Resource/data-source presence check
Diff the type names in provider.go's ResourcesMap/DataSourcesMap against the file names under docs/resources/*.md / docs/data-sources/*.md. Flag:
- A resource/data-source in the schema with no doc page (undocumented)
- A doc page for a resource/data-source no longer in
provider.go (removed but the doc was left behind — the "still references a deprecated/renamed resource" failure mode, e.g. a page for something like confluent_schema_registry_region after it was retired)
2. Attribute-level diff, per resource
For each resource/data-source, extract its attribute map from (or ): attribute name, //, and any / string (shared messages live in , e.g. ). Compare against the argument/attribute reference list in the matching , below the marker. Flag:
