After finishing converting the rest of the Usergrid docs over to Sphinx/Markdown I published the docs the ReadTheDocs.org.
Problem is, though our docs look good on our site, but they look really bad on ReadTheDocs.org. I think this is because ReadTheDocs.org uses the CommonMarkParser instead of the standard Sphinx Markdown parser (because I have tried the CommonMarkParser locally with similar results). Looks good on our site: http://usergrid.incubator.apache.org/docs/data-storage/data-store-dbms.html Same page looks bad/incomplete on ReadTheDocs.org: http://usergrid.readthedocs.org/en/latest/data-storage/data-store-dbms.html I'm not sure how important it is for us to publish to ReadTheDocs.org when the docs work well on our site, and with Sphinx. I'm not really that motivated to fight ReadTheDocs.org. Thoughts? Anybody have experience with Sphinx and CommonMarkParser? Sungju? Thanks, Dave
