bug: TypeSet/TypeList Elements are not rendered in data-sources about terraform-plugin-docs

[aidan-mundy]

EDIT: This problem might only affect providers using the Terraform Plugin SDKv2. I haven't checked with a provider using the Terraform Plugin Framework

Unfortunately this also appears to affect resources.

This issue is a downstream result of the terraform providers schema -json command utilizing an output format for list/set attributes that contains limited information about the list/set contents. Further upstream, that command relies on this json marshaller, and that json is consumed in terraform-plugin-docs via the terraform-json unmarshalling library.

Example in the current format (note, many of the "string" attributes have associated Descriptions, and they are missing here due to the strange format):

"attributes": {
    "builds": {
        "type": [
            "list",
            [
                "object",
                {
                    "id": "string",
                    "images": [
                        "list",
                        [
                            "object",
                            {
                                "created_at": "string",
                                "id": "string",
                                "region": "string"
                            }
                        ]
                    ],
                    "labels": [
                        "map",
                        "string"
                    ],
                    "updated_at": "string"
                }
            ]
        ],
        "description": "Builds for this iteration.",
        "description_kind": "plain",
        "computed": true
    }
}

If I'm reading the discussion in this PR correctly, it looks like the infrastructure exists in terraform and in the downstream terraform-json to allow terraform providers schema -json to output more detailed information about nested types without moving any mountains, it just isn't being used yet.