Index: head/en_US.ISO8859-1/books/handbook/zfs/chapter.xml
===================================================================
--- head/en_US.ISO8859-1/books/handbook/zfs/chapter.xml
+++ head/en_US.ISO8859-1/books/handbook/zfs/chapter.xml
@@ -2716,6 +2716,16 @@
 	used to prevent users or groups from using all of the
 	space in the pool or dataset.</para>
 
+      <para>The following examples assume that the users already
+	exist in the system.  Before adding a user to the system,
+	make sure to create their home dataset first and set the
+	<option>mountpoint</option> to
+	<literal>/home/<replaceable>bob</replaceable></literal>.
+	Then, create the user and make the home directory point to
+	the dataset's <option>mountpoint</option> location.  This will
+	properly set owner and group permissions without shadowing any
+	pre-existing home directory paths that might exist.</para>
+
       <para>To enforce a dataset quota of 10&nbsp;GB for
 	<filename>storage/home/bob</filename>:</para>