docs for catalog maintenance

Buids on (and replaces https://github.com/apache/incubator-brooklyn/pull/399).
does `@./ms.yaml` work?  if so that would be preferable.  (nothing against `martin` but no need to make this personal!)