Bug 264060 - FreeBSD 13.1-RELEASE README: corrections and updates
Summary: FreeBSD 13.1-RELEASE README: corrections and updates
Status: Closed Overcome By Events
Alias: None
Product: Documentation
Classification: Unclassified
Component: Website (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Many People
Assignee: freebsd-doc (Nobody)
URL: https://github.com/freebsd/freebsd-do...
Keywords: needs-patch, needs-qa
Depends on:
Blocks: 264030
  Show dependency treegraph
 
Reported: 2022-05-18 06:38 UTC by Graham Perrin
Modified: 2023-04-05 05:31 UTC (History)
2 users (show)

See Also:
koobs: maintainer-feedback? (re)


Attachments

Note You need to log in before you can comment on or make changes to this bug.
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.