From 6c0dc589ddcbb9a2faf91b92f49db8eb3f592e01 Mon Sep 17 00:00:00 2001 From: Andrew Nicols Date: Mon, 31 Mar 2025 20:32:15 +0800 Subject: [PATCH] [docs] Further clarify final deprecation procedure --- general/development/policies/deprecation/index.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/general/development/policies/deprecation/index.md b/general/development/policies/deprecation/index.md index 5ffee82111..269cb37c66 100644 --- a/general/development/policies/deprecation/index.md +++ b/general/development/policies/deprecation/index.md @@ -147,7 +147,9 @@ public function foobar(int $old, array $params): array { -- Keep the existing parameters and return type for both functions and methods. +- Function and Method signatures **must not change**, that is: + - keep any existing parameters; and + - keep any existing return type. - The deprecation 'since' tag should remain as the version where the initial deprecation happened. - Deprecated classes must be completely removed. - The content of the PHPDoc should be removed, leaving only the `@deprecated` tag with the notice and, optionally, the replacement information. This includes all `@param`, `@return`, and other tags, as well as the description.