Documentation for oci_os_management_hub_software_sources is incorrect (or at least incomplete)

[jeliker]

Community Note

• Please vote on this issue by adding a 👍 reaction to the original issue to help the community and maintainers prioritize this request
• Please do not leave "+1" or "me too" comments, they generate extra noise for issue followers and do not help prioritize the request
• If you are interested in working on this issue or have submitted a pull request, please leave a comment

Terraform Version and Provider Version

Terraform v1.5.7
on darwin_amd64
+ provider registry.terraform.io/oracle/oci v5.42.0

Affected Resource(s)

affected_resources = oci_os_management_hub_software_sources

Terraform Configuration Files

data "oci_os_management_hub_software_sources" "iad" {
  #Required
  compartment_id = local.tenancy_ocid
}

#Comparing to OSMS vs. OSMH above
data "oci_osmanagement_software_sources" "iad" {
  #Required
  compartment_id = local.tenancy_ocid
}

Debug Output

Panic Output

Expected Behavior

1. Per documentation, oci_os_management_hub_software_sources has software_source_collection which apparently is iterable.
   

2. Actually, software_source_collection itself is a list of 1 which contains items which is list of software sources

   This will cause error though documentation suggests otherwise

   [ for s in data.oci_os_management_hub_software_sources.iad.software_source_collection : s.display_name ]

   This will work which is apparent after examining underlying API documentation (vs. Terraform provider docs alone)

   [ for s in data.oci_os_management_hub_software_sources.iad.software_source_collection[0].items : s.display_name ]

3. Compare to this which has similar documentation and behaves as expected.
   

4. This will work for oci_osmanagement_software_sources

   [ for s in data.oci_osmanagement_software_sources.iad.software_sources : s.display_name ]

[tf-oci-pub]

Thank you for reporting the issue. We observed the affected resources are not provided in the description or it's incorrect. We request you to add it in issue description as mentioned in below format.
Example: affected_resources = oci_core_instance , oci_core_instances

If it's not related to any particular resource then mention affected resource as terraform.
Example: affected_resources = terraform

As this works through automation, request you to follow exact syntax.

[jeliker]

Please fix your Bug template to prompt with the format you require! Very frustrating to have to rewrite my report because the template is incorrect. 😑 As I've seen elsewhere, this "awaiting-affected-resources" tag never goes away so now I'm skeptical the issue will ever be reviewed. Bleh!

[jeliker]

Okay, I've updated. We'll see if anything happens...

[jeliker]

I've done as you asked. Please remove awaiting-affected-resources label