Docsetzilla support for RDoc

Docsetzilla is a backbone that builds all docsets for POSH TUI client.

In its infancy, it was just a bunch of scripts on top of YARD and BunnyCDN. But this baby is growing up and now has more tricks up its sleeve. I introduced a bunch of improvements to build docsets faster, but the biggest new feature is support for RDoc.

Docsetzilla is powered by two gems:

• yard-markdown gem for YARD
• rdoc-markdown gem for RDoc

Why support both? YARD claims to support RDoc, but a lot of useful information is still lost in the process. I’m looking to make this tool as informative as possible, and losing such vital data points seemed unacceptable.

The new RDoc maintainer stated that markdown support is a priority for the project going forward. I have also seen an active group on Bundler Slack that is dedicated to improving RDoc. I would like to dive deeper into markdown parser issues that RDoc is currently battling with.