diff --git a/doc/synergy-basic.conf b/doc/synergy-basic.conf
index 2586dfaf..6f3c20d9 100644
--- a/doc/synergy-basic.conf
+++ b/doc/synergy-basic.conf
@@ -2,36 +2,38 @@
 #
 # comments begin with the # character and continue to the end of
 # line.  comments may appear anywhere the syntax permits.
+# +-------+  +--------+ +---------+
+# |Laptop |  |Desktop1| |iMac     |
+# |       |  |        | |         |
+# +-------+  +--------+ +---------+
 
 section: screens
-	# three hosts named:  moe, larry, and curly
-	moe:
-	larry:
-	curly:
+	# three hosts named:  Laptop, Desktop1, and iMac
+	# These are the nice names of the hosts to make it easy to write the config file
+	# The aliases section below contain the "actual" names of the hosts (their hostnames)
+	Laptop:
+	Desktop1:
+	iMac:
 end
 
 section: links
-	# larry is to the right of moe and curly is above moe
-	moe:
-		right = larry
-		up    = curly
+	# iMac is to the right of Desktop1
+	# Laptop is to the left of Desktop1
+	Desktop1:
+		right = iMac
+		left  = Laptop
 
-	# moe is to the left of larry and curly is above larry.
-	# note that curly is above both moe and larry and moe
-	# and larry have a symmetric connection (they're in
-	# opposite directions of each other).
-	larry:
-		left  = moe
-		up    = curly
+	# Desktop1 is to the right of Laptop
+	Laptop:
+		right = Desktop1
 
-	# larry is below curly.  if you move up from moe and then
-	# down, you'll end up on larry.
-	curly:
-		down  = larry
+	# Desktop1 is to the left of iMac
+	iMac:
+		left  = Desktop1
 end
 
 section: aliases
-	# curly is also known as shemp
-	curly:
-		shemp
+	# The "real" name of iMac is John-Smiths-iMac-3.local. If we wanted we could remove this alias and instead use John-Smiths-iMac-3.local everywhere iMac is above. Hopefully it should be easy to see why using an alias is nicer
+	iMac:
+		John-Smiths-iMac-3.local
 end
diff --git a/doc/synergy-stooges.conf b/doc/synergy-stooges.conf
new file mode 100644
index 00000000..2586dfaf
--- /dev/null
+++ b/doc/synergy-stooges.conf
@@ -0,0 +1,37 @@
+# sample synergy configuration file
+#
+# comments begin with the # character and continue to the end of
+# line.  comments may appear anywhere the syntax permits.
+
+section: screens
+	# three hosts named:  moe, larry, and curly
+	moe:
+	larry:
+	curly:
+end
+
+section: links
+	# larry is to the right of moe and curly is above moe
+	moe:
+		right = larry
+		up    = curly
+
+	# moe is to the left of larry and curly is above larry.
+	# note that curly is above both moe and larry and moe
+	# and larry have a symmetric connection (they're in
+	# opposite directions of each other).
+	larry:
+		left  = moe
+		up    = curly
+
+	# larry is below curly.  if you move up from moe and then
+	# down, you'll end up on larry.
+	curly:
+		down  = larry
+end
+
+section: aliases
+	# curly is also known as shemp
+	curly:
+		shemp
+end