terraform-docs should not fail if complex types contain 'description' keyword

[cytopia]

Fix description key inside type

This PR fixes a when a key named description is inside the type block of a variable section:

variable "ingress_cidr_blocks" {
  description = "Bzzzzz"
  type = list(
    object({
      description = string
      cidr_blocks = string
      from_port   = number
      to_port     = number
      protocol    = string
    })
  )

  default = [
    {
      description = "SG"
      cidr_blocks = "10.0.0.0/32"
      from_port   = 22
      to_port     = 22
      protocol    = "tcp"
    },
  ]
}

• Refs: terraform_docs failing on complex types which contains "description"  antonbabenko/pre-commit-terraform#65
• Refs: New error coming from terraform_docs antonbabenko/pre-commit-terraform#64
• Refs: Fixes #65: terraform-docs should not fail if complex types contain 'description' keyword antonbabenko/pre-commit-terraform#73
• Refs: Generate doc failed if "type" present in object definition #170
• Refs: Fix description key inside type cytopia/docker-terraform-docs#23

Integration tests

Test for this can be found here: https://github.com/cytopia/docker-terraform-docs/blob/master/tests/0.12/main.tf#L60

Reliability

I tried to fix this to the best of my knowledge and currently available test cases. Please do test this before merging on existing files.

[cytopia]

@osterman I assume this can be closed, as the new terraform-docs now handles TF >= 0.12 quite well.

[maximmi]

@cytopia thanks, will close this one then