Bug 271658 - FreeBSD Handbook: Guided Partitioning Using Root-on-ZFS: improve the examples
Summary: FreeBSD Handbook: Guided Partitioning Using Root-on-ZFS: improve the examples
Status: Open
Alias: None
Product: Documentation
Classification: Unclassified
Component: Books & Articles (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Some People
Assignee: freebsd-doc (Nobody)
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2023-05-26 18:10 UTC by Graham Perrin
Modified: 2023-11-03 11:54 UTC (History)
2 users (show)

See Also:


Attachments
Screenshot: ZFS configuration: two disks available (10.71 KB, image/png)
2023-05-26 18:14 UTC, Graham Perrin
no flags Details

Note You need to log in before you can comment on or make changes to this bug.
Description Graham Perrin freebsd_committer freebsd_triage 2023-05-26 18:10:08 UTC
<https://docs.freebsd.org/en/books/handbook/bsdinstall/#bsdinstall-part-zfs>

<https://docs.freebsd.org/en/books/handbook/bsdinstall/#bsdinstall-zfs-vdev_type> the selection is 'stripe'. 

In the next image <https://docs.freebsd.org/en/books/handbook/bsdinstall/#bsdinstall-zfs-disk_select>, the reader might reasonably assume that the two selected disks are to be striped. 

In the next image <https://docs.freebsd.org/en/books/handbook/bsdinstall/#bsdinstall-zfs-vdev_invalid>, suddenly it's not striping. 

Also, there's no white space above the image, as if it's Figure 22. It's not, it's Figure 23. 

This subsection might be improved by better titling of figures. Maybe precede one set of figures with explanatory text.
Comment 1 Graham Perrin freebsd_committer freebsd_triage 2023-05-26 18:14:51 UTC
Created attachment 242427 [details]
Screenshot: ZFS configuration: two disks available

Maybe add a subsection for striping (the default) using only one disk. 

(In this case, striping is a misnomer, but we can't do better without a change to the installer.)

Something like the attached screenshot could show that if multiple disks are available (maybe one internal, one external) no more than one should be selected.