docs for catalog maintenance

Buids on (and replaces https://github.com/apache/incubator-brooklyn/pull/399).
oh i got you -- it needs to be wrapped as an app in order to show up as an app in the catalog.  otherwise it shows up as an entity.  worth describing that?