Can I use Terraform-docs to auto generate my variables.tf and outputs.tf files?

[blue928]

I've read through the documentation, and I'm trying to wrap my head around just how far I can customize terraform-docs to do what I need it to do, or maybe it can do it and I just don't realize how to configure it.

My organization's infrastructure has grown. It's no longer possible manually manage input.tf, variables.tf, and outputs.tf files. We need to be able to generate the values in those files as well as update them when the values change.

On the Terraform website, each resource has a resource_name, required arguments, optional arguments, and data that is exported. Let's say I use resource "fake_resource" "fake" {} What I'd like to happen is have a tool that generates a variables block for each argument along with its description and inserts it into variables.tf. The same should happen in the outputs.tf based on data in variables.tf as well as what's exportable per the website exportable attributes reference.

Sorry, I hope that's not too unclear. Is this something that terraform-docs can do? If not do you know of other tools?

Please see my stackoverflow question for details.