Merge pull request #7902 from kenjis/docs-update-backward_compatibility_notes

docs: update Backward Compatibility Notes
This commit is contained in:
kenjis 2023-09-13 14:43:38 +09:00 committed by GitHub
commit ee1f01fba1
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -13,7 +13,8 @@ However, the code is not mature and bug fixes may break compatibility in minor r
What are not Breaking Changes
*****************************
- The deprecated Config items are not covered by backwards compatibility (BC) promise. It may be removed in the next
**minor** version or later.
- The deprecated items are not covered by backwards compatibility (BC) promise. It may be removed in the next next
**minor** version or later. For example, if an item has been deprecated since 4.3.x,
it may be removed in 4.5.0.
- System messages defined in **system/Language/en/** are strictly for internal framework use and are not covered by backwards compatibility (BC) promise. If developers are relying on language string output they should be checking it against the function call (``lang('...')``), not the content.
- `Named arguments <https://www.php.net/manual/en/functions.arguments.php#functions.named-arguments>`_ are not covered by backwards compatibility (BC) promise. We may choose to rename method/function parameter names when necessary in order to improve the codebase.