Of the few community cookbooks I looked at (mysql, apache2, nginx, postgresl, passenger_apache2, yum, ntp), they gave the default in a sentence ie Default is localhost.

However, none of them gave examples unless it was in the description: node['mysql']['client']['packages'] - An array of package names that should be installed on "client" systems. This can be modified, e.g., to specify packages for Percona.

Should we follow this - give the default in a sentence and only list an example if needed to improve the description?