On 09/20/2016 12:25 PM, John Spray wrote:
Hi all, Currently the Ceph upstream documentation is mostly written in restructuredtext, and built into HTML with Sphinx. We at Red Hat have some writer colleagues who are more comfortable with asciidoc, and it has been suggested that we could get more new content upstream (i.e. on github for everyone) if we were using asciidoc. So does anyone have any strong attachment to the restructuredtext format currently in use? (Opinions especially valued from people/groups who are active contributors to the docs)
Took a quick look at how an asciidoc file looks like and, with hard-wrapping the lines, it looks just as readable as rst - give or take a few formatting specificities that could be argued as a trade-off between readability and flexibility.
Personally, I'm not attached to any given format; as long as it's readable on a terminal without having to compile the sources - and it's not latex (being great notwithstanding, seems overkill.)
-Joao -- To unsubscribe from this list: send the line "unsubscribe ceph-devel" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
