Skip to content

docs: Set an EOL for v3.x series - #237

Merged
acoulton merged 4 commits into
Behat:v3.xfrom
acoulton:docs-4.x-release
Sep 28, 2026
Merged

acoulton merged 4 commits into
Behat:v3.xfrom
acoulton:docs-4.x-release

Conversation

@acoulton

Copy link
Copy Markdown
Contributor

Our policy says that we will set an EOL for each major series at the release of the next major, and that we will give at least 12 months of bugfix and 24 months of security.

Now that 4.0 is released, we can set the EOL for 3.x.

We have intentionally restricted the scope of 4.0 so that it should be possible to upgrade most of the way with automated tools (Rector to convert to attributes, in-built tools to migrate to PHP config, etc).

We also know that 3.x has been out for a long time and is generally stable - we don't get huge numbers of new bug reports.

Therefore I think it's fine to offer our minimum 12 month / 24 month EOLs for 3.x.

Our policy says that we will set an EOL for each major series at the release of the next
major, and that we will give at least 12 months of bugfix and 24 months of security.

Now that 4.0 is released, we can set the EOL for 3.x.

We have intentionally restricted the scope of 4.0 so that it should be possible to
upgrade most of the way with automated tools (Rector to convert to attributes,
in-built tools to migrate to PHP config, etc).

We also know that 3.x has been out for a long time and is generally stable - we
don't get huge numbers of new bug reports.

Therefore I think it's fine to offer our minimum 12 month / 24 month EOLs for 3.x.
Now that 4.0 is out, symfony 8 "is" supported :)
Comment thread releases.rst Outdated
======= ========== ============ ============ =======================================================================
Major Released Bugfix EOL Security EOL
======= ========== ============ ============ =======================================================================
`v3.x`_ April 2014 28 Sep 2027 28 Sep 2028 `Changelog <https://github.com/Behat/Behat/blob/3.x/CHANGELOG.md>`__

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I suggest using the end of the month as limit, to simplify things (PHP did something similar for instance)

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Makes sense, thanks - done.

Comment thread releases.rst Outdated
Major Released Bugfix EOL Security EOL
======= ========== ============ ============ =======================================================================
`v3.x`_ April 2014 28 Sep 2027 28 Sep 2028 `Changelog <https://github.com/Behat/Behat/blob/3.x/CHANGELOG.md>`__
`v4.x`_ tbc 2025/6 See below See below `Changelog <https://github.com/Behat/Behat/blob/4.x/CHANGELOG.md>`__

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

the release date should probably be updated

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Yep, missed that at first. Added now.

Simpler than fixing to the exact 12 months from now.

@carlos-granados carlos-granados left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

NIce

@acoulton
acoulton merged commit ee44b4c into Behat:v3.x Sep 28, 2026
3 checks passed
@acoulton
acoulton deleted the docs-4.x-release branch September 28, 2026 17:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants