openstack/openstack-manuals
Code Issues Proposed changes

[contrib-guide] Remove O'Reilly guidelines

Browse Source 
Remove heading guidelines for the Operations Guide,
since we decided at the Austin Design Summit to no
longer publish with O'Reilly.

Change-Id: Ic341951974fbf8df495c5d5b061f6b090ed2a618
Implements: blueprint contributor-guide-reorg
This commit is contained in:
daz 2016-07-12 17:42:21 +10:00
parent 41cfb639ad
commit 2c7e1eb1be
1 changed files with 1 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
doc/contributor-guide/source/writing-style/headings.rst
View File

@ -18,9 +18,7 @@ General guidelines
Use the following guidelines for all types of headings:
* Use sentence-style capitalization except for the Operations Guide, which
follows the `O'Reilly heading capitalization style <http://chimera.labs.oreilly.com/books/1230000000969/ch02.html#headings>`_,
and book titles.
* Use sentence-style capitalization.
* Make headings brief but descriptive.
* Use articles in titles, but do not start the title with an article.
* Avoid using uncommon abbreviations.