YAML is a very easy language to work with. It is very easy for humans to read, and in most cases, it is easy for computers to parse. However, there are little things inside of YAML that can cause pain to even the most experienced users.
YAML is based on a key/value model that is very common in a number of programming languages. In Perl and Ruby it's called a hash, in Python it's called a dictionary (or dict, for short), and in other languages it has other names. Because Salt is written in Python, we'll henceforth refer to it as a dict.
A dict is a set of keys, each of which has a value. This value may be a number of things, including a string, a number, a list (or array), another dict, and so on. The following is a very basic dict, in YAML format:
larry: cheesecake shemp: chocolate cake moe: apple pie
The order of the items in a dict is not normally...