On 27/08/2019 16:24, Andrew Halberstadt wrote:
RST is foreign to most
It turns out* that firefox-source-docs also supports markdown format, so if you have existing docs in that format, or simply feel like needing to learn ReST is a significant impediment to writing docs, that option is available.

The tradeoff is that the featureset of ReST is much larger than that of markdown, so you have to give up some expressiveness and docs/source integration features of Sphinx.

* After some discussion with ahal about the merits of enabling markdown, it turned out that maja_zf already had and the marionette docs are using it.
_______________________________________________
dev-platform mailing list
dev-platform@lists.mozilla.org
https://lists.mozilla.org/listinfo/dev-platform

Reply via email to