Don't suggest that name = value # A comment is a valid definition.

example.cfg

@@ -38,9 +38,11 @@ b = bob_contacts_remote
 # collection each.
 collections = default,work
 
-# conflict_resolution = None  # abort when collisions occur (default)
-# conflict_resolution = a wins  # assume a's items to be more up-to-date
-# conflict_resolution = b wins  # assume b's items to be more up-to-date
+# To resolve a conflict the following values are possible:
+#   `None` - abort when collisions occur (default)
+#   `a wins` - assume a's items to be more up-to-date
+#   `b wins` - assume b's items to be more up-to-date
+#conflict_resolution = None
 
 [storage bob_contacts_local]
 # A storage references actual data on a remote server or on the local disk.
@@ -48,15 +50,19 @@ collections = default,work
 type = filesystem
 path = ~/.contacts/
 fileext = .vcf
-#create = True  # create directory if it doesn't exist
+# Create the directory if it doesn't exist: `True` or `False`
+#create = True
 #encoding = utf-8
 
 [storage bob_contacts_remote]
 type = carddav
 url = https://owncloud.example.com/remote.php/carddav/addressbooks/bob/
-#auth = basic  # basic|digest
-#username =  # for http auth, if empty, no auth will be used
-#password =  # can also be fetched from the system password storage or netrc
+# There are two different authentication types: `basic` or `digest`
+#auth = basic
+# For http auth, if empty, no auth will be used
+#username =
+# The password can also be fetched from the system password storage or netrc
+#password =
 
 #true: The NSA can spy on you with some effort
 #false: Everybody can spy on you with no effort