Page MenuHomeFreeBSD

FreeBSD Handbook: ZFS: correct use of the word 'pool', and a little more
Needs ReviewPublic

Authored by grahamperrin on Feb 25 2023, 9:58 AM.
Tags
None
Referenced Files
Unknown Object (File)
Sat, Apr 27, 3:07 PM
Unknown Object (File)
Sat, Apr 27, 2:37 PM
Unknown Object (File)
Sat, Apr 13, 9:51 AM
Unknown Object (File)
Mon, Apr 8, 10:26 AM
Unknown Object (File)
Dec 20 2023, 8:04 AM
Unknown Object (File)
Dec 10 2023, 9:00 PM
Unknown Object (File)
Nov 20 2023, 9:20 AM
Unknown Object (File)
Nov 11 2023, 3:50 AM

Diff Detail

Repository
R9 FreeBSD doc repository
Lint
Lint Skipped
Unit
Tests Skipped

Event Timeline

A brief line about why "zpool" and "tank" could be useful as they are used throughout the documentation without any explitaion of why or how those labels were used. I think zpool was used because it was a zfs-pool to get away from the "tank" name which I always thought was an odd name but it persists in documentation so I would expect it to be mentioned.

I don't find "== Dataset Administration" clear. Perhaps "== Filesystem Dataset Administration"?

minsoochoo0122_proton.me added inline comments.
documentation/content/en/books/handbook/zfs/_index.adoc
1462

If "zfs Administration" is changing to "Dataset Administration", I think the title for chapter 22.3 also should be changed from "zpool Administration" to "Pool Administration" for consistency. In this way, titles can imply what they do rather than just the name of command, because most users who read this handbook are new to zfs and thus have zero knowledge about zfs and zpool command.