improvements to doc/instructions, mainly to brooklyn.properties