TF: autogenerate ref docs

[marcoandredinis]

Generates a reference.md which should then be copied to
https://github.com/gravitational/teleport/blob/branch/v12/docs/pages/reference/terraform-provider.mdx
Which is exposed here: https://goteleport.com/docs/reference/terraform-provider/

There are some changes because of new fields and login rule reference was moved (to keep an ordered list of resources).

Fixes gravitational/teleport#22083

[hugoShaka]

Fixes gravitational/teleport#22083

[hugoShaka]

non-blocking: I'd prefer using a set of go templates and functions, this would be more readable

[marcoandredinis]

Agreed 👍
I'll change it to use a template

[marcoandredinis]

Can you please take another look?

[ptgott]

Thanks for putting this together! I agree with Hugo re: the template comment, but also that it's fine to leave it for later.

[ptgott]

Actually, one thing

[ptgott]

One thing we should definitely do is indicate that this page was automatically generated using this script and include the teleport-plugins URL. In the docs, content pages include commands using this syntax:

{/*comment text*/}

We should also use mdx for the file extension, not md, to keep this consistent with the rest of the docs (I'm actually not sure if the docs engine cares, so this is just to be safe.)

[marcoandredinis]

Can you please take another look?

[ptgott]

The comment will need to go below the frontmatter block for this to render properly, but otherwise looks great!

[ptgott]

Suggested change

	{/* Content generated by teleport-plugins/terraform/gen/main.go DO NOT EDIT */}
	---
	title: Terraform provider resources
	description: Terraform provider resources reference
	---
	---
	title: Terraform provider resources
	description: Terraform provider resources reference
	---
	{/* Content generated by teleport-plugins/terraform/gen/main.go DO NOT EDIT */}

Otherwise the title won't render