Uh oh!
There was an error while loading. Please reload this page.
Remove now outdated paragraphs from Versions section - #3219
Conversation
handrews
left a comment
There was a problem hiding this comment.
Do we wan to remove this entirely, or explain the exception for OAS 3.0 to OAS 3.1. Either way, I agree it needs to change, and this change would work for me.
MikeRalphson
commented
May 5, 2023
I'm against this change. The 3.0 series of releases has their rules / had them at the time of writing. |
ralfhandl
commented
May 5, 2023
The well-intended 3.0 rules clearly have joined the dinosaurs now, and retaining them in a document published after their demise is really confusing. |
handrews
commented
May 5, 2023
@MikeRalphson what about instead adding a note that this policy was changed in 3.1.0 and referring readers to that document for further details? That would leave the policy as defined in place, but correctly set expectations that it has not been followed exactly. |
MikeRalphson
commented
May 5, 2023
It feels odd to me that a 3.0.x document 'knows about' a 3.1.x document, even if it post-dates it. I think that's my gut objection. |
handrews
commented
May 5, 2023
I think the important thing here is the UX more than forward knowledge. The current text sets an incorrect expectation which is very bad UX. |
ralfhandl
commented
Feb 8, 2024
Closed in favor of #3214 after discussion in TDC |
Fixes#3195
Alternative to #3214