Documentation/gpu: use recommended order of heading markers
authorJani Nikula <jani.nikula@intel.com>
Tue, 21 Jun 2016 11:49:00 +0000 (14:49 +0300)
committerDaniel Vetter <daniel.vetter@ffwll.ch>
Tue, 21 Jun 2016 12:15:18 +0000 (14:15 +0200)
commit22554020409f6febcce2790380e46cd483ae04bb
tree355dfc9c00ced4b9d312457e6c80beb470e159d7
parent621c5474744ce780a5485284273de77b66f4cae2
Documentation/gpu: use recommended order of heading markers

While splitting the document up, the headings "shifted" from what pandoc
generated. Use the following order for headings for consistency:

==============
Document title
==============

First
=====

Second
------

Third
~~~~~

Leave the lower level headings as they are; I think those are less
important. Although RST doesn't mandate a specific order ("Rather than
imposing a fixed number and order of section title adornment styles, the
order enforced will be the order as encountered."), having the higher
levels the same overall makes it easier to follow the documents.

[I'm sort of kind of writing the recommendation for docs-next in the
mean time, but this order seems sensible, and is what I'm proposing.]

Signed-off-by: Jani Nikula <jani.nikula@intel.com>
Signed-off-by: Daniel Vetter <daniel.vetter@ffwll.ch>
Link: http://patchwork.freedesktop.org/patch/msgid/126f42734defac6cbb8496a481d58db7b38461dd.1466506505.git.jani.nikula@intel.com
Documentation/gpu/drm-internals.rst
Documentation/gpu/drm-uapi.rst
Documentation/gpu/i915.rst
Documentation/gpu/introduction.rst