where.adoc: corrections and improvements
ClosedPublic
Actions

Authored by grahamperrin on Sep 11 2022, 2:14 AM.

Details

Reviewers

gjb
carlavilla

Group Reviewers

docs

Commits

R9:4c6c835978d4: where.adoc (Get FreeBSD, Download FreeBSD): corrections and improvements

Summary

Supplemental to D36520:

primarily to remove the section for 13.0, which is EOL
a few corrections (for example, the general advice about mirror sites is misplaced under FreeBSD 12.3-STABLE)
narrower column headings should improve the tables on smaller displays
a few other improvements
generally less verbose.

Test Plan

Mentors: @carlavilla and @gjb

https://reviews.freebsd.org/D36520#829374:

I just noticed, the 13.0 section at https://www.freebsd.org/where/#download-rel130 must be removed.

Would reviewers like a broader diff, to include an edition of website/content/en/where.adoc? Or continue as is, then a separate review for Download FreeBSD a.k.a Get FreeBSD?

... We will handle the rest in another review, ...

Diff Detail

Repository

R9 FreeBSD doc repository

Lint

Lint Skipped

Unit

Tests Skipped

Event Timeline

grahamperrin requested review of this revision.Sep 11 2022, 2:14 AM

grahamperrin created this revision.

grahamperrin added inline comments.Sep 11 2022, 3:46 AM

website/content/en/where.adoc
22
172–175	Some `disc1` images might be too large for CD: https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=257347. CD-ROM is read-only (there's a separate section for purchasing). And so on ...
209	Is there an HTTPS alternative to this `ftp://` URL? If not: make it more immediately clear that this is FTP.
211

grahamperrin marked an inline comment as not done.Sep 11 2022, 3:47 AM

grahamperrin added inline comments.Sep 12 2022, 7:43 PM

website/content/en/where.adoc
192–193

grahamperrin mentioned this in R9:9d5951404e42: Get FreeBSD a.k.a. Download FreeBSD: remove 13.0.Sep 17 2022, 10:37 AM

https://github.com/freebsd/freebsd-doc/commit/9d5951404e425725a84265113abef1c3b2e86d91 removed the dead 13.0 section.

https://github.com/freebsd/freebsd-doc/commit/0cb1a83cb811faed93eb1ede09dbce34d52b94d7 addressed comments.

⋯ sorry, the diff is not what it should be. (I sometimes have difficulty with Git.) ⋯

grahamperrin updated this revision to Diff 110693.Sep 17 2022, 11:24 AM

Some comments: done.

Comment https://reviews.freebsd.org/D36523#inline-224647 (not done) no longer links to the relevant line. I guess, there's no way to avoid this with Phabricator.

grahamperrin added inline comments.Sep 19 2022, 6:56 AM

website/content/en/where.adoc
187	Compare with FreeBSD has also spawned a number of related open source projects: … under https://docs.freebsd.org/en/books/handbook/introduction/#introduction-nutshell-users. https://github.com/freebsd/freebsd-doc/commit/ff0bdebee5553703202c486ac63796140f6396bf#diff-a22a8d445bff4502dfb2a2d284d14bffff391dede55a4c9692ca03e3bcd2ed8bR154 in particular.

Thanks for this!!!
Approved!

This revision is now accepted and ready to land.Sep 21 2022, 6:36 PM

grahamperrin added inline comments.Sep 23 2022, 6:22 AM

website/content/en/where.adoc
209	Found: an HTTPS alternative to the `ftp://` URL. More user-friendly, since some web browsers no longer support FTP. @carlavilla thanks for approval. Assuming no objection (it seems non-contentious), I'll roll this post-approval edit into a diff for commit.