[openstack-dev] [tripleo] blockquotes in docs
Ben Nemec
openstack at nemebean.com
Fri Oct 6 19:15:54 UTC 2017
On 10/06/2017 03:01 AM, Markus Zoeller wrote:
> Just a short reminder that rst puts stuff in blockquotes when you're not
> careful with the spacing. Example:
>
> * item 1
> * item 2
>
> That's in blockquotes because of the 1 blank at the beginning. The
> TripleO docs are full with them, which looks a bit ugly, to be frank.
>
> This change removes all unintentional blockquotes in the tripleo docs:
> https://review.openstack.org/#/c/504518/
>
> You can find them by yourself with:
> $ tox -e docs
> $ grep -rn blockquote doc/build/html/ --include *.html
>
>
> I often use http://rst.aaroniles.net/ for a quick check.
>
I think it's worth noting that people should really be looking at the
output of the docs job when reviewing doc changes. I know my mental RST
parser is full of bugs so it's a job best left to a computer. :-)
-Ben
More information about the OpenStack-dev
mailing list