Skip to content

Commit

Permalink
Extend risks in using YAMLLint and alternative (#3543)
Browse files Browse the repository at this point in the history
* Extends reasoning on YAMLLint

* Removes obsolete whitespace

* Fix whitespace

* Adds reference to inclusion of env-vars in YAML

* Add links
  • Loading branch information
jhoepken authored and fabaff committed Oct 7, 2017
1 parent 43e46a9 commit a69e4f0
Showing 1 changed file with 2 additions and 2 deletions.
4 changes: 2 additions & 2 deletions source/_docs/configuration/yaml.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -30,8 +30,8 @@ The basics of YAML syntax are block collections and mappings containing key-valu

Note that indentation (just like in Python) is an important part of specifying relationships using YAML. Things that are indented are nested "inside" things that are one level higher. So in the above example, `platform: pushbullet` is a property of (nested inside) the `notify` component.
Getting the right indentation can be tricky if you're not using an editor with a fixed width font. Tabs are not allowed to be used for indentation. Convention is to use 2 spaces for each level of indentation.
You can use [YAMLLint](http://www.yamllint.com/) to check if your YAML-syntax is correct before loading it into Home Assistant which will save you some time.
*Please pay attention on not putting in private data, as it is a 3rd-party website not maintained by Home Assistant.*
You can use the online service [YAMLLint](http://www.yamllint.com/) to check if your YAML syntax is correct before loading it into Home Assistant which will save you some time. If you do so, be aware that this is a third-party service and is not maintained by the Home Assistant community. *Please pay attention on not storing private data (passwords, api-keys, etc.) directly in that file.*
Private data can be stored in a [seperate file](/docs/configuration/secrets/) or in [environmental variables](/docs/configuration/yaml/#using-environment-variables), which circumvents this problem of security.

Text following a `#` are comments and are ignored by the system.

Expand Down

0 comments on commit a69e4f0

Please sign in to comment.