explore automating docs generation using `terraform-docs`

[`terraform-docs`](https://terraform-docs.io/) is a plugin for auto-generating terraform module docs and supports, [including examples](https://terraform-docs.io/how-to/include-examples/), as we currently do with our docs.

This will let us ensure that the docs are consistent across modules as the registry size grows.