docs: update changes page#18026
Conversation
|
|
| '/changes/': [ | ||
| { | ||
| text: 'Major Changes', | ||
| text: 'Breaking Changes', |
There was a problem hiding this comment.
One reason to call it "Major Changes" was to avoid the need to force us to document every Breaking Change in the same way. It is kind of "Major Breaking Changes". But probably having breaking here is more clear and we don't need to feel the pressure to have small breaking changes guides.
There was a problem hiding this comment.
That's true, maybe we can mention not all breaking changes are listed here? Or do you think we should still stick with major changes?
There was a problem hiding this comment.
Let's merge and then we can continue refining this later. I think we should at least mention that only major breaking changes will be documented in this way
Description
related #18011
I think I got carried away updating the changes page, but feel free to point out if you don't agree with something. Or if this change is not worth it.
futureoption docs in the shared-options.md page.