I took some time to freshen up https://github.com/cljdoc/cljdoc/blob/master/doc/userguide/for-library-authors.adoc over the last couple of days. Hopefully it is now more digestible, complete and correct.