Place Clojure metrics API docs ahead of Java API docs, since probably more people will use the Clojure API.
And some other tweaks in response to review.
The Clojure metrics API supports metric-ids as vectors of keywords or strings. Previously, the docs only mentioned that keywords could be used. Strings should be used if special characters are needed.