clarify env var msg
href required now by schema? add uri_for_doc convenience method