Skip to content

Add info about feature freeze period #19110

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

Conversation

OskarStark
Copy link
Contributor

@BenMorel
Copy link
Contributor

BenMorel commented Nov 3, 2023

Thank you, @OskarStark!

  • Could the "short timeframe" be defined, like x weeks before release?
  • Could this be reflect on the Symfony Releases Calendar?

@OskarStark
Copy link
Contributor Author

OskarStark commented Nov 3, 2023

Could the "short timeframe" be defined, like x weeks before release?

Not sure, as this is not a hard, more a soft deadline, lets ask @nicolas-grekas and @fabpot

Could this be reflect on the Symfony Releases Calendar?

Not sure it's worth, but possibly yes. But once done, @carsonbot could use that information

@OskarStark OskarStark added the Waiting team decision Request for comments from Symfony Docs Team members label Nov 3, 2023
@xabbuh
Copy link
Member

xabbuh commented Nov 3, 2023

We already document this as the "stabilization" period of two months here: https://symfony.com/doc/current/contributing/community/releases.html#development

@OskarStark
Copy link
Contributor Author

OskarStark commented Nov 3, 2023

I agree, but this does not really explain what that mean for the contributor

@@ -147,6 +147,15 @@ work:
for the ``5.4`` branch, the PR will also be applied by the core team on
all the ``6.x`` branches that are still maintained.

.. warning::
Copy link
Contributor

Choose a reason for hiding this comment

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

isnt "info" enough?
"warning" seem to strong and devs may be not opening new PR :s

what about:

during a short period of time prior to the release of a new symfony major version, the symfony repository
is feature freeze. Your pull requests are still more than welcome nonetheless they must target the next major version

something like that ^^

@@ -147,6 +147,15 @@ work:
for the ``5.4`` branch, the PR will also be applied by the core team on
all the ``6.x`` branches that are still maintained.

.. warning::

For a short timeframe before a new major version is released, we are in a
Copy link
Member

Choose a reason for hiding this comment

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

Is it only before a major version? I have the feeling that I already saw some feature freeze for minor version to stabilize the whole thing, but I may be wrong 🤔

@fabpot
Copy link
Member

fabpot commented Nov 6, 2023

I don't think that this is needed as this is already described here: https://symfony.com/doc/current/contributing/community/releases.html#development

Maybe adding a link to this paragraph would be enough.

@wouterj
Copy link
Member

wouterj commented Nov 6, 2023

I agree that we should not duplicate the release cycle documentation, but I like mentioning it on this page. It's common to see contributors confused what they should do with their PR during this phase. What about replacing the strong warning with a more subtle paragraph like:

During the :ref:`stabilization phase <contributing-release-development>`, the development branch is in
feature freeze. Please help the community prepare for the new version release. If you want to submit a
new feature pull request, you should target the next version. For example, if ``6.3`` reached feature
freeze, new features should target ``6.4``. If the ``6.4`` branch does not yet exists, target ``6.3``
and rebase your pull requests once the branch is created.

(second sentence may be removed, I can't help myself pushing everyone to not focus on writing new features during these 2 months 😛 )

@fabpot
Copy link
Member

fabpot commented Nov 6, 2023

I agree that we should not duplicate the release cycle documentation, but I like mentioning it on this page. It's common to see contributors confused what they should do with their PR during this phase. What about replacing the strong warning with a more subtle paragraph like:

During the :ref:`stabilization phase <contributing-release-development>`, the development branch is in
feature freeze. Please help the community prepare for the new version release. If you want to submit a
new feature pull request, you should target the next version. For example, if ``6.3`` reached feature
freeze, new features should target ``6.4``. If the ``6.4`` branch does not yet exists, target ``6.3``
and rebase your pull requests once the branch is created.

(second sentence may be removed, I can't help myself pushing everyone to not focus on writing new features during these 2 months 😛 )

That works for me

@OskarStark OskarStark force-pushed the feature/add-info-about-feature-freeze-period branch from 7dd1252 to 5f92370 Compare November 6, 2023 13:45
@OskarStark
Copy link
Contributor Author

Thanks @wouterj, I used your proposal

Copy link
Member

@alexandre-daubois alexandre-daubois left a comment

Choose a reason for hiding this comment

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

Great!

@OskarStark OskarStark merged commit 92ff56d into symfony:6.3 Nov 9, 2023
@OskarStark OskarStark force-pushed the feature/add-info-about-feature-freeze-period branch from b2d3433 to 809f169 Compare November 9, 2023 09:01
@OskarStark OskarStark removed the Waiting team decision Request for comments from Symfony Docs Team members label Nov 9, 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.

8 participants