This change fixes all the markup issues in our docs, such as:
* Title length must match an underline (some titles are only 3
characters long, make them longer, otherwise they are not
considered a title);
* Blank line required after literal block;
* Duplicate explicit target name.
It also makes section names consistent in drivers.rst.
Change-Id: I058224589f4ca63a4acfb8e2c4fcdbb51c730542