I see that https://cljdoc.org/d/clj-http/clj-http/3.10.0 has no README b/c it is in .org, not .md/adoc. What is the recommended solution? Ask the project to export .md from .org? Or consider adding support for .org?

Both I guess. Ideally we would support all kinds of formats but in practice that’s hard of course

I am looking at https://github.com/cljdoc/cljdoc/blob/master/doc/userguide/for-library-authors.adoc#basic-setup but do not see a description of where does cljdoc look for the readme file and what names / extensions it looks for, am I blind?

It could be it’s not explicitly documented

But look for derive-toc in the code

FYI I have opened https://github.com/dakrone/clj-http/issues/518

Thx, a PR to add info about README to the docs https://github.com/cljdoc/cljdoc/pull/352/files