Bug 264113

Summary:	FreeBSD 13.1-RELEASE and 13.2-RELEASE documentation fixes and other changes
Product:	Documentation	Reporter:	Graham Perrin <grahamperrin>
Component:	Books & Articles	Assignee:	freebsd-doc (Nobody) <doc>
Status:	Closed FIXED
Severity:	Affects Many People	CC:	bcr, chris, fernape
Priority:	---
Version:	Latest
Hardware:	Any
OS:	Any
URL:	https://www.freebsd.org/releases/13.2R/
See Also:	https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=264030 https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=264060 https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=264142 https://github.com/freebsd/freebsd-doc/pull/165 https://reviews.freebsd.org/D39480
Bug Depends on:
Bug Blocks:	264030

Description Graham Perrin freebsd_committer

2022-05-21 04:12:32 UTC

<https://www.freebsd.org/releases/13.1R/installation/#install>: 

> The Installing FreeBSD chapter …

– 'Installing FreeBSD' can link to 
  <https://docs.freebsd.org/en/books/handbook/bsdinstall/>


<https://www.freebsd.org/releases/13.1R/installation/#upgrade>: 

> … upgrading section …

– 'upgrading' can link to 
  <https://www.freebsd.org/releases/13.1R/relnotes/#upgrade>


<https://www.freebsd.org/releases/13.1R/installation/#upgrade-source>

> … Updating FreeBSD from Source.

– 'Updating FreeBSD from Source' can link to 
  <https://docs.freebsd.org/en/books/handbook/cutting-edge/#makeworld>


<https://www.freebsd.org/releases/13.1R/installation/#upgrade-binary>: 

> The freebsd-update(8) utility supports binary upgrades of 
> i386 and amd64 systems running earlier FreeBSD releases. 
> Systems running 12.3-RELEASE or 13.0-RELEASE can upgrade as follows:

Probably split that into two paragraphs. 

Then, make it understandable that for 13.0-RELEASE, 
binary upgrades to 13.1-RELEASE are: 

* not limited to i386 and amd64
* supported for  i386, amd64 and arm64 (64-bit ARMv8).

<https://old.reddit.com/r/freebsd/comments/ur65ph/-/i9ekbj5/?context=1>: 

> 13.0 to 13.1 should work. 12.3 to 13.1 won't because 
> arm64 isn't tier 1 on 12.x.

Comment 1 Graham Perrin freebsd_committer

2022-05-22 10:25:38 UTC

(In reply to Graham Perrin from comment #0)

> <https://www.freebsd.org/releases/13.1R/installation/#upgrade-binary>: 

Bug 264142 will improve consistency across the various sets of instructions. Cool.

Comment 2 Fernando Apesteguía freebsd_committer

2022-10-09 16:10:11 UTC

^Triage: reporter is committer, assign accordingly.

Comment 3 Graham Perrin freebsd_committer

2023-04-09 20:26:56 UTC

I don't imagine retrospective changes in the /13.1R/ area. 

With today's <https://github.com/freebsd/freebsd-doc/commit/f065edef83d0c6f6c0134dc79d25105d834f08d4>, new files landed in the /13.2R/ area. 

A handful of issues, probably carried forward from previous rounds i.e. nothing new. Given the timescale (Sunday today, Easter holiday tomorrow, 13.2-RELEASE announcement expected on Monday) I sent a couple of emails to re@

----

Triage: add doc@ (lost when this bug was assigned to me).

Comment 4 Graham Perrin freebsd_committer

2023-04-09 20:31:08 UTC

> … 13.2-RELEASE announcement expected on Monday) …

Correction: Tuesday (11th).

Comment 5 commit-hook freebsd_committer

2023-04-10 20:09:13 UTC

A commit in branch main references this bug:

URL: https://cgit.FreeBSD.org/doc/commit/?id=34058151ce23520b26909af0ba27f07151767d6f

commit 34058151ce23520b26909af0ba27f07151767d6f
Author:     Graham Perrin <grahamperrin@FreeBSD.org>
AuthorDate: 2023-04-10 19:54:18 +0000
Commit:     Graham Perrin <grahamperrin@FreeBSD.org>
CommitDate: 2023-04-10 19:54:18 +0000

    13.2R/ final countdown: corrections, improvements

    Fix a handful of errors, some of which were noted in last year's bug
    264113 for the /13.1R/ area but not fixed retrospectively.

    Five commit message in underlying
    https://github.com/freebsd/freebsd-doc/pull/165/commits

    Not intended to be comprehensive, given the timescale;
    https://reviews.freebsd.org/D39480#898747
    draws attention to the absence of rtw88(4) from hardware notes, and
    so on.

    https://bugs.freebsd.org/264113

    PR:                      264113
    Approved by:             re (cperciva, gjb)
    Pull request:            https://github.com/freebsd/freebsd-doc/pull/165
    Differential revision:   https://reviews.freebsd.org/D39480

 shared/en/urls.adoc                                |  3 +++
 .../content/en/releases/13.2R/installation.adoc    |  4 ++--
 website/content/en/releases/13.2R/readme.adoc      | 27 +++++++++++-----------
 3 files changed, 18 insertions(+), 16 deletions(-)

Comment 6 Graham Perrin freebsd_committer

2023-04-10 21:24:34 UTC

(In reply to commit-hook from comment #5)

Two fixes: 

<https://github.com/freebsd/freebsd-doc/commit/f2eaff17798dd4b16a60ee4d326fb17316973109>

<https://github.com/freebsd/freebsd-doc/commit/c24643f2803d5d94ce20d709eae25331a2834d4f>

----

I'd like to review my comment #1 with a clear head, before closing. Maybe next weekend.

Comment 7 Fernando Apesteguía freebsd_committer

2023-08-21 06:24:21 UTC

^Triage: Reporter is committer, assign accordingly

Any committer may commit to any repository with an accepted review from any committer with existing access to that repository.

Committers may obtain review via a Differential in Phabricator, adding the "Contributor Reviewers ($Repository)" group as a Reviewer, reaching out to other committers; directly or via mailing lists, or setting the attachment flag to: maintainer-approval ? <person-youd-like-to-review>

Comment 8 Benedict Reuschling freebsd_committer

2024-05-31 16:00:10 UTC

The releases mentioned are done, no more changes to the release notes are possible. Close this PR.