Skip to content

Remove 7.x versionadded directives #21072

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

Open
wants to merge 1 commit into
base: 8.0
Choose a base branch
from

Conversation

alamirault
Copy link
Contributor

@alamirault alamirault commented Jun 10, 2025

More than 275 new features in 7.x cycle !

@alamirault alamirault requested a review from xabbuh as a code owner June 10, 2025 11:05
@carsonbot carsonbot added this to the 8.0 milestone Jun 10, 2025
Comment on lines -4 to 7
.. versionadded:: 7.3
.. warning::

The ObjectMapper component was introduced in Symfony 7.3 as an
:doc:`experimental feature </contributing/code/experimental>`.
The ObjectMapper component is an :doc:`experimental feature </contributing/code/experimental>`

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Do you have better suggestion ?

Object Mapper component still experimental

Copy link
Member

Choose a reason for hiding this comment

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

I like this proposal too. Thanks.

Copy link
Member

Choose a reason for hiding this comment

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

The component won’t be experimental in 8.0.

Copy link
Member

Choose a reason for hiding this comment

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

As well as in 7.4

@OskarStark
Copy link
Contributor

Please let's do it close to the 8.0 release and not now. The reason is, otherwise every upmerge from a new 7.4 feature would make the CI red in 8.0

@javiereguiluz
Copy link
Member

Oskar, can you please explain this a bit? I don't understand why that would happen. Thanks.

@OskarStark
Copy link
Contributor

Imagine a 7.4 new feature, with a 7.4 versionadded. If you then upmerge to 8.0 branch, doctor on 8.0 will fail as 7.4 versionadded directives would not be allowed per config anymore, so you would need to manually adjust 8.0 then. I would postpone this close to the 8.0 release. Hope it's clear now

@javiereguiluz
Copy link
Member

I disagree with this. If we don't merge this, 8.0 branch will be perpetually red, so we could miss legit errors reported by DOCtor-RST. Although 8.0 doesn't receive new features, but the removal of some deprecations might require to change some contents ... and we could make mistakes there.

You are right that when upmerging 7.4 to 8.0 we'll see an error for any new versionadded directive. But that's common in this repo. E.g. when we still maintained 5.4 and 6.x and 7.x, I had to remove versionadded directives frequently when upmerging between them. I'd say this is expected.

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.

5 participants