@dlesnoff Some really good stuff in there. When I was thinking about fixing the problem, I was reminded that neither I, nor most people new to the community, know RST at all. In most environments, when people are documenting code for extraction, they're using markdown. I am not going to take the time to learn a failed, more complex system, nor are most people.
Adding a markdown option to the doc generation tool seems like a simple thing to do to make it easier for developers new to the ecosystem to get started. Or at least make it easy to find some link to a tool that is markdown-based.
