Bug 273514

Summary: Warn about USE_GITHUB as it's not stable longterm
Product: Documentation Reporter: Daniel Engberg <diizzy>
Component: Books & ArticlesAssignee: Sergio Carlavilla Delgado <carlavilla>
Status: Closed FIXED    
Severity: Affects Many People CC: carlavilla, doc, portmgr
Priority: ---    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
Update USE_GITHUB section none

Description Daniel Engberg freebsd_committer freebsd_triage 2023-09-02 08:27:21 UTC 
Created attachment 244579 [details]
Update USE_GITHUB section

We need to look into how to handle USE_GITHUB and ports using *github.com/*/archive/* for longterm stability. This will obviously not only affect FreeBSD so I'm going to assume it's going to be a push from all distros to create release assets.

I apologize if I botched the syntax, I don't know how to generate new docs however I think I got the syntax correct otherwise feel free to submit a fixed version and/or rephrase it.

Reference:
https://github.blog/2023-02-21-update-on-the-future-stability-of-source-code-archives-and-hashes/
Comment 1 Sergio Carlavilla Delgado freebsd_committer freebsd_triage 2023-09-02 08:34:57 UTC 
It's fine, will make a little change and make the commit :)
Comment 2 commit-hook freebsd_committer freebsd_triage 2023-09-02 09:26:47 UTC 
A commit in branch main references this bug:

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(+)
Comment 3 Sergio Carlavilla Delgado freebsd_committer freebsd_triage 2023-09-02 09:27:02 UTC 
Done!
Comment 4 Daniel Engberg freebsd_committer freebsd_triage 2023-09-02 09:30:32 UTC 
Thanks!
Comment 5 Graham Perrin 2023-09-02 11:08:26 UTC 
diizzy@ thanks, also FYI bug 258314 comment 3 with regard to GitLab, Gitea and sourcehut.