OpenAPI-Specification icon indicating copy to clipboard operation
OpenAPI-Specification copied to clipboard

No release includes the fixes to the cross-references

Open MikeSpreitzer opened this issue 1 year ago • 2 comments

Recall that #3548 tracked a change in how GitHub renders markdown to HTML, 8 months ago. There is not yet any tagged commit in this repo that includes this fix.

MikeSpreitzer avatar Oct 14 '24 16:10 MikeSpreitzer

@MikeSpreitzer that's because they're not re-releases and you can't really change tags in git (not without causing tons of problems). For the versions directory, the markdown on the main branch is what's rendered as HTML on spec.openapis.org (for the schemas directory its more complicated and currently under review).

We made the changes in-place for convenience of people browsing in GitHub, because broken links are bad. But it's not a change in the spec itself.

handrews avatar Oct 14 '24 21:10 handrews

@MikeSpreitzer if that doesn't make sense, it would help to know what you're trying to do with the tags. When we made that change, we couldn't really figure out how the tags were used (no one involved in deciding to make them was available and remembered).

handrews avatar Oct 14 '24 21:10 handrews

This issue has been labeled with No recent activity because there has been no recent activity. It will be closed if no further activity occurs within 28 days. Please re-open this issue or open a new one after this delay if you need to.

github-actions[bot] avatar Oct 22 '24 14:10 github-actions[bot]

We've recently released new versions, @MikeSpreitzer, could you confirm if https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.1.md has the fixes you were hoping for?

lornajane avatar Nov 04 '24 16:11 lornajane

This issue has been labeled with No recent activity because there has been no recent activity. It will be closed if no further activity occurs within 28 days. Please re-open this issue or open a new one after this delay if you need to.

github-actions[bot] avatar Nov 04 '24 16:11 github-actions[bot]

I was not asking for a change in a tag, I was asking for a new tag. 3.1.1 fits the bill. Thanks!

MikeSpreitzer avatar Nov 04 '24 16:11 MikeSpreitzer