diff options
author | Christopher Speller <crspeller@gmail.com> | 2015-11-13 06:19:06 -0500 |
---|---|---|
committer | Christopher Speller <crspeller@gmail.com> | 2015-11-13 06:19:06 -0500 |
commit | 5b02bc69fc86ef4e4358ff3f717d900b11484a66 (patch) | |
tree | 9a30f28cbb2c89ffa054424a4faac02110d7dca0 /doc/process/documentation-guidelines.md | |
parent | 2c40f776f88b7e95dc568b0a0764c9e9237bf67f (diff) | |
parent | 10a8e968fe0bc6f61e747e0cd66ce4fbd9d9bb15 (diff) | |
download | chat-5b02bc69fc86ef4e4358ff3f717d900b11484a66.tar.gz chat-5b02bc69fc86ef4e4358ff3f717d900b11484a66.tar.bz2 chat-5b02bc69fc86ef4e4358ff3f717d900b11484a66.zip |
Merge pull request #1414 from lindy65/patch-9
Update documentation-guidelines.md
Diffstat (limited to 'doc/process/documentation-guidelines.md')
-rw-r--r-- | doc/process/documentation-guidelines.md | 21 |
1 files changed, 19 insertions, 2 deletions
diff --git a/doc/process/documentation-guidelines.md b/doc/process/documentation-guidelines.md index f186da6bd..e75bb3169 100644 --- a/doc/process/documentation-guidelines.md +++ b/doc/process/documentation-guidelines.md @@ -41,7 +41,7 @@ This procedure works on Linux servers running Python 2.6 and higher. ### Use headings -Headings in markdown provide anchors that can be used to easily reference sub-sections of long pieces of documentation. This is preferrable to just numbering sections without headings. +Headings in markdown provide anchors that can be used to easily reference sub-sections of long pieces of documentation. This is preferable to just numbering sections without headings. ##### Correct: @@ -77,7 +77,24 @@ H3, H4, H5 headings should be "Sentence case" and can be any length. These headers are smaller and used to summarize sections. H3 can be considered either a large or small heading. -These conventions are new, so there's flexibility around them, when you're not sure, consider the convention here as default. +These conventions are new, so there's flexibility around them, when you're not sure, consider the convention here as default. + +### Sub-section headings should end with a colon + +For readability and clear layout, end a sub-section heading with a colon + +##### Correct: + +---- +Service Based: +- [AWS Elastic Beanstalk Setup](https://github.com/mattermost/platform/blob/master/doc/install/Amazon-Elastic-Beanstalk.md) +---- +##### Incorrect: + +---- +Optional +- [Community Guide for Production Debian Setup](https://github.com/mattermost/platform/blob/master/doc/install/Production-Debian.md) +---- ### One instruction per line |