[docs] Fix generating constructor examples for resources that have numeric enums as input

[Zaid-Ajaj]

Description

Fixes #16191

The original issue is that the intermediate PCL we generate used enum names instead of enum values for numeric enum inputs. This PR changes it so that the PCL program now uses the first numeric value for the first enum case then subsequently fixing downstream program-gen bugs that didn't know how to handle numeric values as inputs for enums.

Checklist

• I have run make tidy to update any new dependencies
• I have run make lint to verify my code passes the lint check
  • I have formatted my code using gofumpt

• I have added tests that prove my fix is effective or that my feature works

• I have run make changelog and committed the changelog/pending/<file> documenting my change

• Yes, there are changes in this PR that warrants bumping the Pulumi Cloud API version

[pulumi-bot]

Changelog

[uncommitted] (2024-05-29)

Bug Fixes

• [docs] Fix generating constructor examples for resources that have numeric enums as input
  #16223

[justinvp]

Should we also add a test case for non-numeric enum?

[Zaid-Ajaj]

Done ✅

[justinvp]

Is there a test that demonstrates this? Do we really use new?

[Zaid-Ajaj]

I looked at the generated and their was a constructor that accepts double but now I checked again and that constructor is private 😅

private TeamStackPermissionScope(double value)

there is actually no way to construct the enum from a number (it's generated as a struct). I changed the previous behaviour because it was panicking too early and unnecessarily so I though I would just fix it but this won't do. Will bring back the previous behaviour without redundantly panicking. Also we could change sdk-gen in dotnet to make the constructor public or add an implicit cast operator but that is for another PR.

[Zaid-Ajaj]

Old behaviour is back without panicking too early ✅ constructing a numeric enum from a number value will be handled in a separate PR

[Frassle]

Mostly looks ok, odd that java and yaml are using the numeric values rather than enums though? Is that because they need fixes in their code generators?

[Zaid-Ajaj]

Is that because they need fixes in their code generators?

@Frassle that's right