Left a comment on the gist.

re: PR to the metrics apb repo, is that ok in the context of aggregating this and other service docs together, given that we'll have service docs that are common to all services ie. https://issues.jboss.org/browse/AEROGEAR-1817

cc paul wright