Hi Peter, I meant to get to your specific ZFS doc comments earlier, but ZFS boot and install tasks took over my brain for about 6 months. I apologize.
Regarding these comments: Page 25 Monitoring ZFS disk space. It should be explained that ZFS quotas are something different to normal filesystem quotas. It may be better not to refer to them as quotas at all. Something like 'You can limit the amount of space used by a ZFS filesystem by ...'. (And a note that snapshots count against the limit too.) I updated this section to include a link back to the full description of ZFS quotas and reservations so readers can review this information and decide whether they want to use or not. This section also describes how to use refquota and refreserv properties to set quotas without accounting for snapshots. Thanks for taking the time to comment. Cindy Peter Tribble wrote: > On Wed, Aug 20, 2008 at 6:42 PM, Kathy Slattery <kathy.slattery at sun.com> > wrote: > >>A new version of the OpenSolaris System Administration Guide >>that will be included in the Student Pack can be found at: >> >>http://www.opensolaris.org/os/project/indiana/files > > > Some quick miscellaneous comments: > > It says 'your laptop'. I feel that's a little too specific - readers > may interpret > that as meaning you can't use other types of computer. > > Page 10. I wouldn't introduce svcadm before mentioning svcs. > > Page 11/12 modifying NWAM. Step 5. You don't restart the service, you enable > it again. > > Page 13 'Manually configuring a wired connection'. Step 2. Should disable > come before enable? Step 3. So how could you tell that bge0 is the wired > interface? I mean, I know that the wired broadcom and ath0 the wireless > atheros, but how does a new user work that out? > > Page 14/15 Manually configuring wireless. Same as above. Step 6, is that > "connect-wifi-e" or "connect-wifi -e"? > > Page 25 Monitoring ZFS disk space. It should be explained that ZFS quotas > are something different to normal filesystem quotas. It may be better not to > refer to them as quotas at all. Something like 'You can limit the > amount of space > used by a ZFS filesystem by ...'. (And a note that snapshots count against > the limit too.) > > Page 27 'How to see available NFS shares' Confused me. What's missing from the > text is that 'localserver' is the host that you want to query to see > what filesystems > it's exporting. Otherwise it appears in the command for no reason. (And would > 'remoteserver' be a better name?) >
