1. Home
  2. Documentation
  3. Modernisation Platform User Guide
  4. Creating Automated Terraform Documentation

Creating Automated Terraform Documentation

Overview

The Modernisation Platform use a Documentation GitHub Workflow to automate Terraform documentation. The workflow automatically searches then creates and populates tables using the variables, providers, modules, versions used in your Terraform code.

Configuration to run documentation workflow

  1. Ensure you have a copy of documentation.yml in your .github/workflows/ directory.

  2. Create a top-level file called README.md in your repository.

  3. Add the following two lines to your README.md file:

<!--- BEGIN_TF_DOCS --->

<!--- END_TF_DOCS --->
  1. The GitHub workflow will create the automated documentation in between these two tags and commit them when a pull request is created. You may include any custom markdown instructions outside of the tags.
Last reviewed: 12 November 2025Review status: ⚠ Review soonOwner: #modernisation-platformSource: View source on GitHub

Was this page useful?