[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. :-)


More information about the OpenStack-dev mailing list