Skip to content

Add a section about how to add an argument to a method without breaking BC #17706

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Jan 11, 2023

Conversation

fabpot
Copy link
Member

@fabpot fabpot commented Jan 10, 2023

Our section about BC breaks is too strict in the sense that we do have solutions for some of the things mentioned as not possible.
This PR documents one of them.

@carsonbot carsonbot added this to the 5.4 milestone Jan 10, 2023
@fabpot fabpot force-pushed the bc-break-workarounds branch 4 times, most recently from 84b7133 to d187536 Compare January 10, 2023 11:08
@fabpot fabpot force-pushed the bc-break-workarounds branch from d187536 to 43f5a76 Compare January 10, 2023 11:12
{
}

#. Document the new argument in a PHPDoc::
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We can mention this must be documented in all child classes.

Copy link
Member

@stof stof left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We should probably also document the strategy to add new methods in an interface

@fabpot
Copy link
Member Author

fabpot commented Jan 10, 2023

We should probably also document the strategy to add new methods in an interface

Probably the next to document indeed.

@javiereguiluz
Copy link
Member

Thank you Fabien.

@javiereguiluz javiereguiluz merged commit b7408ea into symfony:5.4 Jan 11, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

6 participants