Doc and Config fixups.

Be explicit about linux package names for those not familiar with
the platform. Also more explicit about steps such as editing file,
and testing the daemon.

Remove leading whitespace from commented-out config examples.
Set default parallel DNS back to 10, and suggest override of 100 in
config file. Enforce skipped DNS for autoconf IPs if unset (this is
a consequence of the way Dancer merges the two files - top level
config cannot be in both files).

Netdisco/share/environments/deployment.yml

@@ -20,34 +20,36 @@ database:
 
 # will be stripped from fqdn when displayed in the web UI
 # also, do not forget the leading dot.
-#  domain_suffix: '.example.com'
+# ```````````````````````````````````````````````````````
+#domain_suffix: '.example.com'
 
-# uncomment and set to true to disable authentication/login.
-#  no_auth: false
+# uncomment and set to true to disable authentication/login
+# `````````````````````````````````````````````````````````
+#no_auth: false
 
-# community: ['public']
-# community_rw: ['private']
+# SNMP community string(s)
+# ````````````````````````
+#community: ['public']
+#community_rw: ['private']
 
-# when not set, Netdisco loads all MIBs in mibhome directory.
-#  mibdirs:
-#    - cisco
-#    - rfc
-#    - net-snmp
+# daemon will keep netdisco up to date on this schedule
+# `````````````````````````````````````````````````````
+#housekeeping:
+#  discoverall:
+#    when: '5 7 * * *'
+#  macwalk:
+#    when:
+#      min: 20
+#  arpwalk:
+#    when:
+#      min: 50
+#  nbtwalk:
+#    when: '0 8,13,21 * * *'
+#  expiry:
+#    when: '20 23 * * *'
 
-# housekeeping:
-#   discoverall:
-#     when: '5 7 * * *'
-#   macwalk:
-#     when:
-#       min: 20
-#   arpwalk:
-#     when:
-#       min: 50
-#   nbtwalk:
-#     when: '0 8,13,21 * * *'
-#   expiry:
-#     when: '20 23 * * *'
+# increase the performance of parallel DNS resolution for node names
+# (the default is max_outstanding: 10)
+#dns:
+#  max_outstanding: 100
 
-# expire_devices: 60
-# expire_nodes: 90
-# expire_nodes_archive: 60