Metric structure example and better documentation

[voetberg]

@scarletnorberg brought up that it isn't obvious that you need to set the self.output attribute for the metric to get ""finish"" to work properly.

This should be more clearly documented in the contributing guide.