Document API conventions better

[michaelklishin]

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.