docs: discourage use of list tables
authorJonathan Corbet <corbet@lwn.net>
Mon, 3 Jan 2022 22:33:47 +0000 (15:33 -0700)
committerJonathan Corbet <corbet@lwn.net>
Fri, 7 Jan 2022 16:33:13 +0000 (09:33 -0700)
commitdb67eb748e7a8e9310accf3eff606b40008ef145
tree01c45f3e91c0f969740076a1ddb77fe6f3ef3235
parentbf33a9d42d0c1003bca4aebfabcd22e69aae979f
docs: discourage use of list tables

Our documentation encourages the use of list-table formats, but that advice
runs counter to the objective of keeping the plain-text documentation as
useful and readable as possible.  Turn that advice around the other way so
that people don't keep adding these tables.

Acked-by: Christoph Hellwig <hch@lst.de>
Acked-by: Randy Dunlap <rdunlap@infradead.org>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Documentation/doc-guide/sphinx.rst