Bug 264113 - FreeBSD 13.1-RELEASE and 13.2-RELEASE documentation fixes and other changes
Summary: FreeBSD 13.1-RELEASE and 13.2-RELEASE documentation fixes and other changes
Status: Open
Alias: None
Product: Documentation
Classification: Unclassified
Component: Books & Articles (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Many People
Assignee: freebsd-doc (Nobody)
URL: https://www.freebsd.org/releases/13.2R/
Keywords:
Depends on:
Blocks: 264030
  Show dependency treegraph
 
Reported: 2022-05-21 04:12 UTC by Graham Perrin
Modified: 2023-08-22 06:00 UTC (History)
2 users (show)

See Also:


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-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 freebsd_triage 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 freebsd_triage 2022-10-09 16:10:11 UTC
^Triage: reporter is committer, assign accordingly.
Comment 3 Graham Perrin freebsd_committer freebsd_triage 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 freebsd_triage 2023-04-09 20:31:08 UTC
> … 13.2-RELEASE announcement expected on Monday) …

Correction: Tuesday (11th).
Comment 5 commit-hook freebsd_committer freebsd_triage 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 freebsd_triage 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 freebsd_triage 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>