Page MenuHomeFreeBSD
Differential D57051

Where: Clarify choosing an Image section
ClosedPublic
Actions

Authored by carlavilla on May 17 2026, 4:29 PM.
Tags
None
Referenced Files
Unknown Object (File)
Sun, May 31, 10:14 AM
Unknown Object (File)
Sun, May 31, 10:10 AM
Unknown Object (File)
Sun, May 31, 2:34 AM
Unknown Object (File)
Sun, May 31, 2:29 AM
Unknown Object (File)
Sat, May 30, 9:35 PM
Unknown Object (File)
Sat, May 30, 9:31 PM
Unknown Object (File)
May 27 2026, 12:08 PM
Unknown Object (File)
May 26 2026, 11:26 PM
View All 22 Files
Subscribers
dch
ziaee

Details

Reviewers
dch
ziaee
Group Reviewers
docs
releng
Commits
R9:c5f5bbff55fe: Website - Where: Clarify choosing an Image section
Summary

PR: 285517

Diff Detail

Repository
R9 FreeBSD doc repository
Lint
Lint Not Applicable
Unit
Tests Not Applicable

Event Timeline

carlavilla requested review of this revision.May 17 2026, 4:29 PM
carlavilla created this revision.
ziaee added a subscriber: ziaee.May 17 2026, 4:48 PM

ive also been working on this, here's the render i've got so far https://freebsd.org/~ziaee/tmp/where.png

dch requested changes to this revision.May 19 2026, 7:42 AM
dch added a subscriber: dch.

LGTM. We can expand the BASIC-CI image a little bit further if you like, up to you. Upstream doesn't make sense to me here, so "other" seems a reasonable swap.

`BASIC-CI` images are minimal FreeBSD builds with cloudinit-compatible
`nuageinit(7)` scripting installed by default, to enable custom automated
scripting on startup. These are used by other projects to run test
suites; they are not part of FreeBSD's own CI infrastructure.

ok?

This revision now requires changes to proceed.May 19 2026, 7:42 AM
carlavilla mentioned this in D57161: where: Revise Choosing an Image.May 22 2026, 6:05 AM
carlavilla mentioned this in D57165: where: Streamline.May 22 2026, 6:10 AM
ziaee added inline comments.May 22 2026, 6:26 AM
website/content/en/where.adoc
39

What if we did this, to make it more consistent with the table:

* SD Card images: Pre-installed systems for single-board computers such as the Raspberry Pi.

Also, pre-installed is an important point like we mentioned in the bullet above.

carlavilla updated this revision to Diff 178372.May 22 2026, 6:33 AM

Update diff with changes requested

carlavilla marked an inline comment as done.May 22 2026, 6:33 AM
ziaee accepted this revision as: ziaee.May 22 2026, 6:34 AM
This revision was not accepted when it landed; it landed in state Needs Review.May 22 2026, 6:50 AM
Closed by commit R9:c5f5bbff55fe: Website - Where: Clarify choosing an Image section (authored by carlavilla). · Explain Why
This revision was automatically updated to reflect the committed changes.
carlavilla added a commit: R9:c5f5bbff55fe: Website - Where: Clarify choosing an Image section.
ziaee added a comment.May 22 2026, 6:24 PM

Honestly, this section was broken and is still broken, because the section is called "choosing an image" but it does not explain the images. BASIC-CI, the most FAQ, now has a disclaimer that it is not what the reader intuitively thinks is, which is a doc smell, due to the an extremely unequal weighting of information where no other VM image is even explained at all. Cloudinit images are not mentioned, and they are the hot thing right now. The difference between DVD1 vs disc1 is not explained at all, so people will still ask questions about what those are.

carlavilla added a comment.May 23 2026, 6:39 AM
In D57051#1310344, @ziaee wrote:

Honestly, this section was broken and is still broken, because the section is called "choosing an image" but it does not explain the images. BASIC-CI, the most FAQ, now has a disclaimer that it is not what the reader intuitively thinks is, which is a doc smell, due to the an extremely unequal weighting of information where no other VM image is even explained at all. Cloudinit images are not mentioned, and they are the hot thing right now. The difference between DVD1 vs disc1 is not explained at all, so people will still ask questions about what those are.

Yes, it's true, I think we need to work in a new about section and also in a new download section

Revision Contents
Changeset List

PathSize
website/
content/
en/
8 lines

Diff 178374

View Options

website/content/en/where.adoc

Loading...