|author||Fernando Apesteguía <fernape@FreeBSD.org>||2023-04-25 16:24:09 +0000|
|committer||Fernando Apesteguía <fernape@FreeBSD.org>||2023-04-27 12:48:15 +0000|
[phb]: Add note when deprecating ports.
Mention alternative ports in the commit msg. Too often people complain about not knowing alternatives for deprecated ports. Reviewed by: bofh@, pauamma_gundo.com Differential Revision: https://reviews.freebsd.org/D39804
1 files changed, 7 insertions, 0 deletions
diff --git a/documentation/content/en/books/porters-handbook/porting-dads/_index.adoc b/documentation/content/en/books/porters-handbook/porting-dads/_index.adoc
index 7977293b4a..a02b45962b 100644
@@ -448,6 +448,13 @@ Both will be shown to the user.
It is possible to set `DEPRECATED` without an `EXPIRATION_DATE` (for instance, recommending a newer version of the port), but the converse does not make any sense.
+When marking a port as `DEPRECATED`, if there are any alternative ports that can
+be used as a replacement for the one being deprecated, it is convenient to
+mention them in the commit message.
There is no set policy on how much notice to give.
Current practice seems to be one month for security-related issues and two months for build issues.
This also gives any interested committers a little time to fix the problems.