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)
Mon, Nov 11, 7:08 AM
Unknown Object (File)
Oct 25 2024, 4:15 PM
Unknown Object (File)
Oct 5 2024, 6:07 AM
Unknown Object (File)
Sep 25 2024, 8:24 AM
Unknown Object (File)
Sep 24 2024, 4:11 AM
Unknown Object (File)
Sep 21 2024, 1:49 AM
Unknown Object (File)
Sep 17 2024, 2:05 PM
Unknown Object (File)
Aug 24 2024, 2:51 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.