Sphinx uses plain ReST tables, and from what I can tell, ReST has 4 (yes, 4!) ways of marking up tables:<br><br>Grid tables<br><a href="http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#grid-tables">http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#grid-tables</a><br>
- ASCII-art style tables<br><br>Simple Tables<br><a href="http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#simple-tables">http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#simple-tables</a><br>
- A different style of ASCII-art table, simpler but less powerful than Grid Tables<br><br>CSV Tables<br><a href="http://docutils.sourceforge.net/docs/ref/rst/directives.html#csv-table">http://docutils.sourceforge.net/docs/ref/rst/directives.html#csv-table</a><br>
- data is provided in CSV format in the body of a ReST directive<br><br>List Tables<br><a href="http://docutils.sourceforge.net/docs/ref/rst/directives.html#list-table">http://docutils.sourceforge.net/docs/ref/rst/directives.html#list-table</a><br>
- data is provided as nested lists in the body of a ReST directive<br><br>My question is, what format should the lore2sphinx tool target?<br><br>Any of these formats should work fine, but I&#39;m curious as to what people (in particular the core devs) think as to which should be the preferred method in the Sphinx documentation.<br>
<br>Keep in mind that there are only 2 tables in all of the Twisted docs, and one of them is in the documentation for Lore, which (hopefully!) should be going away once this project is completed.  So it&#39;s not like it would be a whole lot of work to change the preferred format later.<br>
<br>Kevin Horn<br>