SUP-1293 Generate docs from code

[jradtilbrook]

PR checklist:

• docs/ updated
  • add import examples
  • update examples with comments to explain them
• tests added
• an example added to examples/ (useful to demo new field/resource)
• CHANGELOG.md updated with pending release information

[jradtilbrook]

Honestly, there isnt much point reviewing this! 😰

Everything under docs/ is generated so that can basically be ignored. The changes to the rest is the actual content. But its also hard to review it.

I'm wondering if we merge this, create a release like 1.0.0-docs.beta or something. So we can check it out on terraform registry and see it rendered and review it there

[james2791]

🚀

[jradtilbrook]

Ive created this registry off of this branch https://registry.terraform.io/providers/jradtilbrook/greatest/latest (I forked the repo).

So we can view the docs there and review things from the rendered output.

I also tested the semver stuff. The registry shows the latest release docs but installing it is not possible unless you specify the exact version. Eg 2.0.0-beta will install, but ~> 2.0 will not. And that is what we want for the v1 release