improvements to doc/instructions, mainly to brooklyn.properties

Merge of #1304 with `master` but including the note and link to the main jclouds provider page, as suggested by @jdtoy