docs for catalog maintenance

Buids on (and replaces https://github.com/apache/incubator-brooklyn/pull/399).