Re: [PATCH 1/2] Documentation/core-api/device_link: Add initial documentation

From: Jonathan Corbet
Date: Mon Dec 05 2016 - 08:06:07 EST


On Mon, 5 Dec 2016 10:07:39 -0200
Mauro Carvalho Chehab <mchehab@xxxxxxxxxxxxxxx> wrote:

> > +Usage
> > +=====
>
> You should be using, instead:
>
> Usage
> -----
>
> (and the same '-' symbol for all sections of this chapter)
>
> The way you did, in thesis, ReST should be putting all tags at the
> same level as the first one, as they're all using '='.

Actually, he did exactly what the documentation guide says to do. Since
it only has the markers below the heading, it will still be at a lower
level than the top heading, which has markers both above and below.

jon