[Bug]: [sample] can't link to correct sample when operationId is not unique

Azure / typespec-azure

About TypeSpec Azure Libraries

https://azure.github.io/typespec-azure/

MIT License

15 stars 41 forks source link

[Bug]: [sample] can't link to correct sample when operationId is not unique #1469

Closed MaryGao closed 3 weeks ago

MaryGao commented 2 months ago

Describe the bug

See openapi issue, we can't link to correct sample when operationId is not unique

Reproduction

playground

Checklist

[X] Follow our Code of Conduct
[X] Check that this issue is about the Azure libraries for typespec. For bug in the typespec language or core libraries file it in the TypeSpec repo
[X] Check that there isn't already an issue that request the same bug to avoid creating a duplicate.
[X] The provided reproduction is a minimal reproducible example of the bug.

tadelesh commented 2 months ago

it should be the underlying operation id issue. operation id does not honor namespace hierarchy.

tadelesh commented 3 weeks ago

i think the ultimate solution for example is to use @example from typespec. tcgc will not handle this conflict since it is an underlying problem and may not exist for the ultimate solution.