While there:
- Use architecture-agnostic URLs.
- Make FAQ 10.18 less dramatic and less condescending.
PR: 261816 [1]
Details
Details
- Reviewers
carlavilla - Group Reviewers
docs - Commits
- R9:9f81e7c44fcf: Fix version numbers in FAQs
make
lynx
Diff Detail
Diff Detail
- Repository
- R9 FreeBSD doc repository
- Lint
Lint Not Applicable - Unit
Tests Not Applicable
Event Timeline
Comment Actions
A few suggestions. Hopefully not contentious. Thanks
| documentation/content/en/books/faq/_index.adoc | ||
|---|---|---|
| 240 | Recent versions are | |
| 241–244 | branches | |
| 241–244 | I'm more familiar with snapshots appearing approximately weekly, although I understand that frequencies will vary across branches and platforms. For example, at the time of writing: 20220512, 20220519 and 20220527 at https://download.freebsd.org/snapshots/ISO-IMAGES/14.0/. https://www.freebsd.org/snapshots/ seems to make no promise about frequency. Instead, there's acknowledgement that things may be somewhat outdated. I suggest removing the word monthly. | |
| 241–244 | Consider removing this phrase. At least: I should not describe STABLE as bleeding edge. Readers can learn about the nature of snapshots at https://www.freebsd.org/snapshots/. | |
| 241–244 | It's potentially confusing to describe snapshots (of branches that are not RELEASE) as snapshot releases. Some overlap with use of the phrase FreeBSD Snapshot Releases at https://www.freebsd.org/snapshots/. | |
Comment Actions
Some more outdated references to 11.3, and so on.
| documentation/content/en/books/faq/_index.adoc | ||
|---|---|---|
| 2 | Is it necessary to be specific? Consider removing the tail of this line. (Some of the answers relate to 14.0-CURRENT.) | |
| 577 | Outdated links. | |
| 666 | Outdated links. For a future review, re: https://forums.freebsd.org/posts/554130 (discussion with Joseph Mingrone) IMHO we should make clear that hardware notes are not intended to be comprehensive. Frankness about their scope should not lessen the value of the notes. FAQ might be an ideal place for this frankness. | |
Comment Actions
Thanks for the review.
| documentation/content/en/books/faq/_index.adoc | ||
|---|---|---|
| 2 | Not sure about necessary, and I agree some of it is about -CURRENT or applicable to it, but 12 and 13 are the intended primary focus, so it's at the very least useful. | |
| 240 | Went for "supported" | |
| 241–244 | No idea; perhaps someone who knows what happens and what's meant to happen can say. Leaving all undone, and focusing on versions and the extra easy change I snuck in, as I have other changes I need to make anyway. | |
| 666 | Tweaked that a bit while here. | |