コーディングスタイル

• 例やTerraformモジュールには、機能と使用方法を説明するドキュメントを含める必要があります。

• README.mdファイル内のすべてのリンクは絶対Pathにし、Terraform Registryのウェブサイトで正しく表示されるようにします。

• ドキュメントには、mermaidで作成した図やcloudcraft.coで作成した設計図を含めることができます。

• Terraformのプリコミットフック(Terraform pre-commit hooks)を使用して、コードが正しく、適切にフォーマットされ、自動的にドキュメント化されるようにし、Gitにプッシュされる前に確認できるようにしてください。

ドキュメンテーション

ドキュメントの自動生成

pre-commitは、マルチランゲージのプリコミットフックを管理および維持するためのフレームワークです。Pythonで書かれており、コードがGitリポジトリにコミットされる前に、開発者のマシン上で自動的に何かしらの処理を行うための強力なツールです。通常は、リンターを実行したり、コードをフォーマットしたりするために使用されます（サポートされているフックを参照）。

Terraformの構成では、pre-commitを使用してコードをフォーマットし、検証し、ドキュメントを更新することができます。

pre-commit-terraformリポジトリをチェックして、使い方を把握し、すでに使用されている既存のリポジトリ（例：terraform-aws-vpc）を確認してください。

terraform-docs

terraform-docsは、さまざまな出力形式でTerraformモジュールからドキュメントを生成するツールです。手動で実行することもできます（プリコミットフックなしで）、または pre-commit-terraform hooks を使用してドキュメントを自動的に更新することもできます。

@todo: モジュールのバージョン、リリース、GHアクションを文書化する

参照

1. pre-commit framework homepage

2. Collection of git hooks for Terraform to be used with pre-commit framework

3. Blog post by Dean Wilson: pre-commit hooks and terraform - a safety net for your repositories