I’m glad you’re thinking about this in a forward-looking way!
One thought: our convention has ben that repos named openmrs-module-* refer to modules themselves. Perhaps a new convention to start would be openmrs-doc-*, so in this case you’d call it openmrs-doc-module-radiology.
your totally right, there is no reason. spring-xd also has it in the same repo with their code. I am also in favor of having it all in one place.
I just wanted to get asciidoctor setup first and gain some more experience with it. I’ll integrate it soon.
there is even a maven plugin for generating the html, but I guess there’s a maven plugin for almost anything
There’s a hypothetical benefit of having all openmrs repos be named openmrs-* (and therefore openmrs-doc-xyz is “better” than doc-openmrs-xyz), but there’s not any actual tooling or process built around this idea.