Re: [openstack-dev] [docs][all] Front page template for project team documentation

2018-07-21 Thread Jean-Philippe Evrard
Is there a lint tool that can catch incoherent markup at a global project level (vs at a page gen level)? Any tool to catch these issues would help. JP. On July 19, 2018 3:55:29 PM UTC, Petr Kovar wrote: >Hi all, > >A spin-off discussion in https://review.openstack.org/#/c/579177/ >resulted

Re: [openstack-dev] [docs][all] Front page template for project team documentation

2018-07-19 Thread Petr Kovar
Hi all, A spin-off discussion in https://review.openstack.org/#/c/579177/ resulted in an idea to update our RST conventions for headings level 2 and 3 so that our guidelines follow recommendations from http://docutils.sourceforge.net/docs/user/rst/quickstart.html#sections. The updated

[openstack-dev] [docs][all] Front page template for project team documentation

2018-06-29 Thread Petr Kovar
Hi all, Feedback from the Queens PTG included requests for the Documentation Project to provide guidance and recommendations on how to structure common content typically found on the front page for project team docs, located at doc/source/index.rst in the project team repository. I've created a