Skip to main content
The Terraform Plugin Testing library provides acceptance testing and unit testing helpers for Terraform provider developers. Its documentation covers test configuration, step-based testing, import testing, and assertion patterns. It is versioned and stored in content/terraform-plugin-testing/. The content API uses the terraform product slug. The navDataPath for this directory is plugin-testing, and content is served under the /plugin/testing/ URL base path.

Content directory

content/terraform-plugin-testing/
├── v1.0.x/
├── v1.1.x/
├── v1.2.x/
├── v1.3.x/
├── v1.4.x/
├── v1.5.x/
├── v1.6.x/
├── v1.7.x/
├── v1.8.x/
├── v1.9.x/
├── v1.10.x/
├── v1.11.x/
├── v1.12.x/
├── v1.13.x/
├── v1.14.x/
└── v1.15.x/
Each version directory follows the standard structure:
content/terraform-plugin-testing/<version>/
├── docs/            # Markdown content files
├── data/            # Navigation sidebar JSON files
└── img/             # Image assets

URL base paths

Terraform Plugin Testing content is served under /plugin/testing/.

Available versions

Versions v1.0.x through v1.15.x are present in the repository.
Older versions (v1.0.x and earlier) may fail migration scripts with errors indicating missing img/ or data/ directories. Confirm the directory structure before editing older versions.

Finding and editing Plugin Testing docs

1

Find the version directory

List the available version directories:
ls content/terraform-plugin-testing/
2

Navigate to the content files

Content files are in the docs/ subdirectory within each version folder:
ls content/terraform-plugin-testing/v1.15.x/docs/
3

Edit the file

Open the .mdx file you want to change.
4

Update navigation if needed

Navigation sidebar data is in content/terraform-plugin-testing/<version>/data/.

Product configuration reference

AttributeValue
productSlugterraform
navDataPathplugin-testing
contentDirdocs (in source repo)
websiteDirwebsite (in source repo)
dataDirdata
assetDirimg
basePathsplugin/testing
versionedDocstrue

Build docs developers (and LLMs) love