In my opinion, I don't think it's "worse", just simpler. Plus it's more ubiquitous, supported by Github etc etc. Although Github may not be the best yardstick

In my opinion, I don't think it's "worse", just simpler. Plus it's more ubiquitous, supported by Github etc etc. Although Github may not be the best yardstick there, because they render documents written in Emacs' org-mode too! (which I very much appreciate, I prefer writing in org to writing in Markdown) I'm hoping that LLMs will make it more streamlined when documenting existing code. Not so much as a replacement for text written by experts, but in converting code into diagrams. LLMs or similar "understand" a codebase by tokenizing it (as is my understanding), so turning that into a nice documentation skeleton should be possible.