shade/doc/source
Akihiro Motoki 262061afd0 Improve doc formatting a bit
After migrating to openstackdocstheme, some shade document became
not easy to read. This commit fixes them a bit.

- openstackdocstheme assumee only one title per page.
  Use a different level of title for the title.
  Otherwise, titles with the same level are not shown.
- Release notes page has a lot of sections. It leads to a long TOC
  in the user guide index page.
  Use maxdepth=1 explicitly for the release notes.
- Add a link to a simple example to usage.rst.
  It helps users who access the user guide directly.

Change-Id: If51afa471505296b502bed3288cc9bcf30a69ba3
2017-07-12 06:50:19 +00:00
..
contributor reorganize docs using the new standard layout 2017-06-30 10:07:41 -04:00
install reorganize docs using the new standard layout 2017-06-30 10:07:41 -04:00
releasenotes reorganize docs using the new standard layout 2017-06-30 10:07:41 -04:00
user Improve doc formatting a bit 2017-07-12 06:50:19 +00:00
conf.py switch from oslosphinx to openstackdocstheme 2017-06-30 10:14:38 -04:00
index.rst Improve doc formatting a bit 2017-07-12 06:50:19 +00:00