Re: [openstack-dev] [tripleo] blockquotes in docs

2017-10-06 Thread Ben Nemec



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

__
OpenStack Development Mailing List (not for usage questions)
Unsubscribe: openstack-dev-requ...@lists.openstack.org?subject:unsubscribe
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev


[openstack-dev] [tripleo] blockquotes in docs

2017-10-06 Thread Markus Zoeller
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.

-- 
Regards, Markus Zoeller (markus_z)


__
OpenStack Development Mailing List (not for usage questions)
Unsubscribe: openstack-dev-requ...@lists.openstack.org?subject:unsubscribe
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev