I guess the (and again, if I understand it and javadoc correctly (very possible I don't)) it being centered around comments in-file over well completely separate files. In mdbook (and I guess generally gitbook which it seems is wholesale cloned or at least heavily inspired from) you're writing documentation with code and dokka seems like you're writing code with documentation.