Add style guide

source/_includes/asides/developers_navigation.html

@@ -17,6 +17,7 @@
           <li>{% active_link /developers/development_environment/ Setting up Environment %}</li>
           <li>{% active_link /developers/development_submitting/ Submit your Work %}</li>
           <li>{% active_link /developers/development_checklist/ Checklist %}</li>
+          <li>{% active_link /developers/development_guidelines/ Style guidelines %}</li>
           <li>{% active_link /developers/development_testing/ Testing %}</li>
           <li>{% active_link /developers/development_catching_up/ Catching up with Reality %}</li>
           <li>{% active_link /developers/development_validation/ Validation %}</li>

source/developers/development_guidelines.markdown

@@ -0,0 +1,81 @@
+---
+layout: page
+title: "Style guidelines"
+description: "Details about styling your code."
+date: 2017-04-28 20:00
+sidebar: true
+comments: false
+sharing: true
+footer: true
+---
+
+Home Assistant enforces strict [PEP8 style](https://www.python.org/dev/peps/pep-0008/) and [PEP 257 (Docstring Conventions)](https://www.python.org/dev/peps/pep-0257/) compliance on all code submitted. We automatically test every pull request as part of the linting process with [Coveralls](https://coveralls.io/github/home-assistant/home-assistant) and [Travis CI](https://travis-ci.org/home-assistant/home-assistant).
+
+Summary of the most relevant points:
+
+- Line length is limited to 79 characters (see below).
+- Use 4 spaces per indentation level. We don't use tabs.
+- Comments should be full sentences and end with a period.
+- [Imports](https://www.python.org/dev/peps/pep-0008/#imports) should be ordered.
+- Constants and the content of lists and directories should be in alphabetical order.
+- Avoid trailing whitespace but surround binary operators with a single space.
+- Line separator should be set to `LF`.
+
+The maximum line length comes directly from the [PEP8 style guide](https://www.python.org/dev/peps/pep-0008/#maximum-line-length), and is also used by the Python standard library. All code must pass these linting checks, and no exceptions will be made. There have already been numerous requests to increase the maximum line length, but after evaluating the options, the Home Assistant maintainers have decided to stay at 79 characters. This decision is final.
+
+Those points may require that you adjust your IDE or editor settings.
+
+## {% linkable_title Our recommandations %}
+
+For some cases [PEPs](https://www.python.org/dev/peps/) don't make a statement. This section covers our recommandations about the code style. Those points were collected from the exisiting code and based on what contributors and developers were using the most. This is basically a majority decision, thus you may not agree with it. But we would like to encourage you follow those recommandations to keep the code unified. 
+
+### {% linkable_title Quotes %}
+
+Use single quotes `'` for single word and `"` for multiple words or sentences.
+
+```python
+ATTR_WATERLEVEL = 'level'
+CONF_ATTRIBUTION = "Data provided by the WUnderground weather service"
+SENSOR_TYPES = {
+    'alerts': ['Alerts', None],
+}
+```
+
+### {% linkable_title File headers %}
+
+The docstring in the file header should contain a link to the documentation to make it easy to find further information, especially about the configuration or details which are not mentioned in the code. 
+
+```python
+"""
+Support for MQTT lights.
+
+For more details about this platform, please refer to the documentation at
+https://home-assistant.io/components/light.mqtt/
+"""
+```
+
+### {% linkable_title Requirements %}
+
+Please place [Platform requirements](/developers/code_review_platform/#1-requirements) right after the imports. 
+
+```python
+[...]
+from homeassistant.helpers.entity import Entity
+
+REQUIREMENTS = ['xmltodict==0.11.0']
+```
+
+### {% linkable_title Log messages %}
+
+There is no need to add the platform or component name to the log messages. This will be added automatically. Like `syslog` messages there shouldn't be no period at the end. Try to avoid brackets and additional quotes around the output to make it easier for users to parse the log. A widely style is shown below but you are free to compose the messages as you like.
+
+```python
+_LOGGER.error("No route to device: %s", self._resource)
+```
+
+```bash
+2017-05-01 14:28:07 ERROR [homeassistant.components.sensor.arest] No route to device: 192.168.0.18
+```
+
+Don't print out wrong API keys, tokens, usernames, or passwords.
+

source/developers/development_testing.markdown

@@ -9,11 +9,11 @@ sharing: true
 footer: true
 ---
 
-Home Assistant enforces strict [PEP8 style](https://www.python.org/dev/peps/pep-0008/) compliance on all code submitted. We automatically test every pull request with [Coveralls](https://coveralls.io/github/home-assistant/home-assistant) and [Travis CI](https://travis-ci.org/home-assistant/home-assistant).
+As states in the [Style guidelines section](/developers/development_guidelines/) all code is checked as part of the linting process and unit test were run.
 
 ### {% linkable_title Local testing %}
 
-**Important:** Run tox before you create your pull request to avoid annoying fixes. Local testing requires installing tox.
+**Important:** Run `tox` before you create your pull request to avoid annoying fixes. Local testing requires installing `tox`.
 
 ```bash
 $ pip3 install tox
@@ -63,6 +63,3 @@ The `flake8-docstrings` extension will check docstrings according to [PEP257](ht
 
 If you can't avoid a PyLint warning, add a comment to disable the PyLint check for that line with `# pylint: disable=YOUR-ERROR-NAME`. An example of an unavoidable PyLint warning is not using the passed-in datetime if you're listening for a time change.
 
-### {% linkable_title Maximum Line Length %}
-
-As part of the linting process, all code is checked for a maximum line length of 79 characters. This comes directly from the [PEP8 style guide](https://www.python.org/dev/peps/pep-0008/#maximum-line-length), and is also used by the Python standard library. All code must pass these linting checks, and no exceptions will be made. There have already been numerous requests to increase the maximum line length, but after evaluating the options, the Home Assistant maintainers have decided to stay at 79 characters. This decision is final.