Bug 271658

Summary: FreeBSD Handbook: Guided Partitioning Using Root-on-ZFS: improve the examples
Product: Documentation Reporter: Graham Perrin <grahamperrin>
Component: Books & ArticlesAssignee: freebsd-doc (Nobody) <doc>
Status: Open ---    
Severity: Affects Some People CC: emaste, pat
Priority: ---    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
Screenshot: ZFS configuration: two disks available none

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.