Document API conventions better

In 2.0, we now have an API convention: most (if not all) functions that define/return metrics accept a metrics registry as their first argument, or it can be omitted, then `metrics.core/default-registry` will be used. This is kind of reflected in the docs now
but needs to be made clearer.
