Allow subcategories under the "Guides" heading

[marcosuma]

Terraform CLI and terraform-plugin-docs Versions

any version

Use Cases or Problem Statement

The TF registry docs do not allow subcategories under the "Guides" heading and suggests breaking out additional guides into new headings (docs). This makes it hard for the user to figure out what is a Guide or not.

Proposal

We want the same ability we have for other parts of the documentation, such as Resources and Data Sources, to better use subcategories for user discoverability.

How much impact is this issue causing?

Medium

Additional Information

No response

Code of Conduct

• I agree to follow this project's Code of Conduct

[ansgarm]

Hi @marcosuma, thank you for raising this!

I spoke to the Terraform Registry team which would need to build such a feature before this tool can implement this. And as they don't have a public issue tracker, we decided to keep this issue open for others to upvote it, so we can gauge interest and hopefully land this on the Registries roadmap at some future point.

So, whoever might read this comment: Upvote the original issue if you need this 👍