Bug 264060

Summary: FreeBSD 13.1-RELEASE README: corrections and updates
Product: Documentation Reporter: Graham Perrin <grahamperrin>
Component: WebsiteAssignee: freebsd-doc (Nobody) <doc>
Status: Closed Overcome By Events    
Severity: Affects Many People CC: emaste, re
Priority: --- Keywords: needs-patch, needs-qa
Version: LatestFlags: koobs: maintainer-feedback? (re)
Hardware: Any   
OS: Any   
URL: https://github.com/freebsd/freebsd-doc/blob/main/website/content/en/releases/13.1R/readme.adoc
See Also: https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=264113
Bug Depends on:    
Bug Blocks: 264030    

Description Graham Perrin freebsd_committer freebsd_triage 2022-05-18 06:38:44 UTC 
<https://www.freebsd.org/releases/13.1R/readme/>

Outdated links include: 

> mailing lists section

* refers to       <https://www.freebsd.org/support/#mailing-list>
* should refer to <https://www.freebsd.org/community/mailinglists/>

> A list of all active PRs

* refers to       <https://bugs.freebsd.org/search/> (not a list)
* redirects to <https://bugs.freebsd.org/bugzilla/query.cgi?format=advanced> 
* should either refer to a meaningful list, or rephrase the sentence

> hypertext manual pages gateway

* is underlined as if it should be a link
* is not a link
* maybe it should refer to <https://www.freebsd.org/cgi/man.cgi>

> FreeBSD Documentation page

* refers to       <https://www.freebsd.org/doc> (404, not found)
* should refer to <https://docs.freebsd.org/>

> or its mirrors.

* is docs.freebsd.org truly mirrored?

> bibliography

* refers to       <https://docs.freebsd.org/en/books/handbook/#bibliography>
* presents the front page of the split HTML edition of the Handbook
* should refer to <https://docs.freebsd.org/en/books/handbook/bibliography/> 
           | <https://docs.freebsd.org/en/books/handbook/book/#bibliography>
Comment 1 Graham Perrin freebsd_committer freebsd_triage 2022-05-18 06:43:37 UTC 
> … If you’re tracking the 13-STABLE …

Honestly, stuff like this doesn't belong in the README for RELEASE. 

And so on …

----

Generally: maintenance of /releases/ pages such as this should become less of a chore if the pages can cease (or minimise) duplication/triplication of what is (or should be) generic information that's elsewhere in the FreeBSD site.
Comment 2 Graham Perrin freebsd_committer freebsd_triage 2022-05-18 06:55:51 UTC 
> Important … to be subscribed. Use the Mailman interface instead.

I think not. 

Pages such as <https://lists.freebsd.org/archives/freebsd-questions/> have, as a footer: 


> Other: [ Active mailing lists ] [ Archives from mailman's time ]

– from which I assume use of Mailman (to subscribe) was historic. 

<https://lists.freebsd.org/subscription/freebsd-announce> mentions mlmmj.
Comment 3 Graham Perrin freebsd_committer freebsd_triage 2023-04-05 05:31:48 UTC 
I'm too weary, from git at the command line, to think about reworking this for future documentation.