title: How to describe an object type variable in Terraform?
body: <p>I am trying to write a clear documentation/description of my terraform modules.
  According to <a href="https://www.terraform.io/language/values/variables" rel="nofollow noreferrer">Hashicorp's doc</a>, the <code>description</code> attribute will permit that, but I cannot find a way to describe an <code>object</code> type variable in details.</p>
  <p>Here's more or less I want to do :</p>
  <pre><code>variable &quot;sa_to_impersonate_info&quot; {
    type = object(
      {
        id                   = string
        email                = string
        belonging_org_id     = string
        belonging_project_id = string
        token_scopes         = list(string)
        token_lifetime       = string
      }
    )
    description = {
      id : &quot;an identifier for the resource with format projects/{{project}}/serviceAccounts/{{email}}&quot;
      email : &quot;Email of the service account to impersonate&quot;
      belonging_org_id : &quot;Organization ID where the service account belongs&quot;
      belonging_project_id : &quot;Porject ID where the service account belongs&quot;
      token_scopes : &quot;List of scopes affected by this service account impersonation&quot;
      token_lifetime : &quot;Time the token will be active&quot;
    }
  }
  </code></pre>
  <p>For this format I get this error when I perform a <code>terraform plan</code>:</p>
  <pre><code> Error: Unsuitable value type
  </code></pre>