Fixed and added docs about clusters.json, other misc markdown adjustments.

Bugs closed: AURORA-55

Reviewed at https://reviews.apache.org/r/17072/