add metrics docs, use sane defaults
merge