docs: Add CHANGELOG for 3.33.0 (#1885)

docs: add changelog for 4.0.0-alpha1 (#1857)

docs: Add CHANGELOG for version 3.32.0 (#1855)

And fix the release date shown for 3.31.0, which I managed to put as
2025 🤦

docs: Add changelog for v3.31.0 (#1829)

docs: Add changelog for 3.30.0 (#1810)

Depends on Behat/docs#219 to add the documentation for the parser mode
configuration.

[3.x] refactor: Add initial backwards-compatible return types (#1763)

This is a first pass at adding backwards-compatible return types that we
can safely merge into the 3.x series, as we work towards #1744.

Return types are added to:

* public, protected and private methods in `final` classes
* private methods in `non-final` classes
* `final public` methods in `non-final` classes

The return types applied are based on:

* Rector's type coverage rules (up to level 21) - these are based on the
actual type returned where this can be conclusively determined from
static analysis.
* Manual modification to the phpdoc `@return` type of any interface the
method implements, if this was less specific than the type that Rector
detected. This is the type Rector would have used if the interface had a
strict return type, but we cannot add those until 4.x.

It also includes some improvements / corrections to invalid or 
old-style phpdoc `@return` tags for lists / arrays etc that phpstan
was previously ignoring but are now checked due to the presence
of a runtime return type.

Merge pull request #1775 from acoulton/next-3.x

docs: Add changelog for 3.28.0

Release 3.27.0

Add changelog for 3.26.0 release (#1683)

Add changelog for 3.25.0 release (#1670)