config defaults tidying

Netdisco/share/config.yml

@@ -108,7 +108,11 @@ macsuck_no: []
 macsuck_only: []
 macsuck_all_vlans: false
 macsuck_no_unnamed: false
-macsuck_no_vlan: [fddi-default,token-ring-default,fddinet-default,trnet-default]
+macsuck_no_vlan:
+  - 'fddi-default'
+  - 'token-ring-default'
+  - 'fddinet-default'
+  - 'trnet-default'
 macsuck_no_devicevlan: []
 macsuck_bleed: false
 macsuck_min_age: 0

Netdisco/share/environments/deployment.yml

@@ -40,8 +40,8 @@ snmp_auth:
 #    read: false
 #    write: true
 
-# daemon will keep netdisco up to date on this schedule
+# this is the schedule for automatically keeping netdisco up-to-date
-# `````````````````````````````````````````````````````
+# ``````````````````````````````````````````````````````````````````
 #schedule:
 #  discoverall:
 #    when: '5 7 * * *'
@@ -65,12 +65,13 @@ discover_no_type:
   - '(?i)(?:wap|wireless)'
 
 # number of SNMP workers to run in parallel (in netdisco-daemon).
-# the default is twice the number of CPU cores
+# the default is twice the number of CPU cores. increase this if
+# your system has few cores and the schedule is taking too long.
 # ```````````````````````````````````````````````````````````````
 #workers:
 #  tasks: 'AUTO * 2'
 
-# amount parallel DNS resolution for node names
+# number of parallel DNS queries for node names
 # `````````````````````````````````````````````
 #dns:
 #  max_outstanding: 50