Centralize our docs generators

[ptgott]

Details

We maintain a number of scripts in gravitational/teleport for generating docs, including:

• Terraform reference docs
• Operator resource reference docs
• Helm chart reference docs

...with others soon to be added. Let's come up with a clean, centralized way to either run or organize these so they're easier to maintain.

How will we know this is resolved?

We have implemented one or both of these solutions:

1. Placed all generators in a single directory or GitHub repo (if we opt for the latter, we can pin a repo version to prevent generator changes from immediately breaking CI)
2. Added a Make target that runs all docs generators, plus another target that checks if the current docs are up to date (i.e., for CI)

Related Issues