TASK: Add breaking change documentation

Also order changelog entries news first.
This commit is contained in:
Daniel Siepmann 2018-03-08 09:54:34 +01:00
parent a965b745ec
commit e960f4595b
Signed by: Daniel Siepmann
GPG key ID: 33D6629915560EF4
2 changed files with 14 additions and 1 deletions

View file

@ -5,4 +5,5 @@ Changelog
:maxdepth: 1
:glob:
changelog/*
changelog/20180408-introduce-php70-type-hints
changelog/20180406-120-facet-configuration

View file

@ -0,0 +1,12 @@
Breacking Change "Introduce PHP 7.0 TypeHints"
==============================================
As PHP evolved, we now migrate the whole code base to use PHP 7.0 type hints.
We do not use PHP 7.1 Type Hints, as some customers still need PHP 7.0 support.
Also we added missing methods to interfaces, that were already used in code.
As this leads to changed method signatures, most custom implementations of interfaces, or overwrites
of existing methods are broken.
To fix, just update the signatures as pointed out by PHP while running the code.