Tables are very useful and rST markup offers different ways to create them.
We prefer list-tables because they allow you to put as much content as you need without painting ASCII-style borders:
.. container:: table .. list-table:: :widths: 25 75 :header-rows: 1 * - Name - Use * - :doc:`/reference/reference_lua/box_ctl/wait_ro` - Wait until ``box.info.ro`` is true
This is how the table will look like:
Notice that we use
* and then
- in tables because it is more readable
when rows and columns marked differently.