Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Interesting i never knew we had a breaking changes section before.
Currently we generate the change log using our own generator.
If we add this section back, we need to add it there as well.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Though i am not sure f the implications for maintainers, would this mean another label we need to add on PR's?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
There already is a label, is think it's just not being used in the changelog generator, as far as I see: breaking change
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I also think mentioning that
csr
is now a required Cargo feature for old code to continue working is worth mentioning somewhere in the changelog. This doesn't seem directly and explicitly mentioned as far as I can see, and certainly not prominent like in a breaking change section.There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
We never had a section for breaking changes, only migration guide. The breaking change label isn't used in the change log generator
I think this information can go in the migration guide (if not present already)
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Yes, all the breaking changes are recorded in the migration guide.
I am in favour of having a breaking change section in the changelog.
However, if we were to accept this pull request, we also need to retrospectively pick all breaking changes from the changelog for v0.20.
Maybe it would be better to start tracking breaking changes from the next release?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Given this, I would suggest to link the migration guide from the top of the changelog.
I did not know such existed, which was why I was looking at the changelog after my code broke upon updating. I just tried to find the migration guide and had some difficulty with this step. I'm still not sure I was looking at the correct document, but the document I found seemed perhaps a bit incomplete.