Dokka supposedly allows to add markdown files to the generated documentation pages. This would improve the quality of the documentation website. README files contain many relative links though, so this might require some additional investigation.