search for: 7d1be2b9

...9;ll try to put your points into a new Tech Writer's FAQ, unless you want the honor yourself now that you are working on Sphinx documents. > > -------------- next part -------------- An HTML attachment was scrubbed... URL: <http://lists.llvm.org/pipermail/llvm-dev/attachments/20120614/7d1be2b9/attachment.html>

As I read, I'm writing stuff here things come to me: 1. Don't indent the list. Some of the other RST files do this, but it is incorrect since it indents the list! The list is semantically "at the top level" of indentation (it's not a sub-element of anything). 2. don't have that mini "table of contents" list at the beginning. sphinx will generate that itself