OpenAPI: Enums are missing description, and x-enumNames

[niemyjski]

Is there an existing issue for this?

• I have searched the existing issues

Describe the bug

Enums are missing description, and x-enumNames. See SampleModel.BillingStatus (#58230 (comment)) kind of covers this, but not addressed and x-ms-enum is not an industry standard and should be removed (If it is included this way which it is not).

Expected Behavior

These should just work out of the box.

Steps To Reproduce

Clone https://github.com/exceptionless/aspnet-core-net10-issues# and run it, hit the open api json endpoint.

Exceptions (if any)

No response

.NET Version

10 preview 6

Anything else?

MacOS Latest, Rider/VS Code

#62150

[captainsafia]

Guidance on emitting enums is documented in https://learn.microsoft.com/en-us/aspnet/core/fundamentals/openapi/include-metadata?view=aspnetcore-9.0&tabs=minimal-apis#enum.

In .NET 10, we full support enums using the new support in OpenAPI v3.1.

[dotnet-policy-service]

This issue has been resolved and has not had any activity for 1 day. It will be closed for housekeeping purposes.

See our Issue Management Policies for more information.

[niemyjski]

@captainsafia are you saying this will be supported in .NET 10 if so what version because last time I looked this was not working in my attached sample. I'm not wanting string enum values (just the enum value names). I want friendly enum names to be generated so I can generate enums that look good but also have any comments. See https://github.com/exceptionless/Exceptionless/blob/main/src/Exceptionless.Web/ClientApp/src/lib/generated/api.ts#L34-L54 which was generated.