diff --git a/sanoid.conf b/sanoid.conf
index c082bac..0650c3d 100644
--- a/sanoid.conf
+++ b/sanoid.conf
@@ -31,6 +31,10 @@
 # you can also handle datasets recursively in an atomic way without the possibility to override settings for child datasets.
 [zpoolname/parent2]
 	use_template = production
+	# there are two options for recursive: zfs or yes
+	# * zfs - taken a zfs snapshot with the '-r' flag; zfs will recursively take a snapshot of the whole
+	#         dataset tree which is consistent.
+	# * yes - the snapshots will be taken one-at-time through the sanoid code; not necessarily consistent.
 	recursive = zfs