git: 8f81121599 - main - Porter's handbook: Warn about USE_GITHUB as it's not stable longterm

The branch main has been updated by carlavilla:

URL: https://cgit.FreeBSD.org/doc/commit/?id=8f811215993b7b9ec439ecf1af2acae61fecbc29

commit 8f811215993b7b9ec439ecf1af2acae61fecbc29
Author:     Daniel Engberg <diizzy@FreeBSD.org>
AuthorDate: 2023-09-02 09:25:19 +0000
Commit:     Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
CommitDate: 2023-09-02 09:25:19 +0000

    Porter's handbook: Warn about USE_GITHUB as it's not stable longterm
    
    Some litle tweaks to the patch by carlavilla@
    
    PR:             273514
---
 .../content/en/books/porters-handbook/makefiles/_index.adoc        | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/documentation/content/en/books/porters-handbook/makefiles/_index.adoc b/documentation/content/en/books/porters-handbook/makefiles/_index.adoc
index ac8a9a5f51..9dcab0012c 100644
--- a/documentation/content/en/books/porters-handbook/makefiles/_index.adoc
+++ b/documentation/content/en/books/porters-handbook/makefiles/_index.adoc
@@ -1440,6 +1440,13 @@ MASTER_SITE_SUBDIR=	stardict/WyabdcRealPeopleTTS/${PORTVERSION}
 
 If the distribution file comes from a specific commit or tag on https://github.com/[GitHub] for which there is no officially released file,
 there is an easy way to set the right `DISTNAME` and `MASTER_SITES` automatically.
+
+[WARNING]
+====
+As of 2023-02-21 link:https://github.blog/2023-02-21-update-on-the-future-stability-of-source-code-archives-and-hashes/[GitHub] have announced that source downloads will be stable for a year.
+Please switch to release assets and if not available ask upstream to generate ones.
+====
+
 These variables are available:
 
 [[makefile-master_sites-github-description]]