Document YAML escape requirements for special syntaxes

[fabre-thibaud]

Some constructs conflict with YAML syntax, like the null coalesce operator (?:).

Documentation should emphasize on those constructs that need to be properly escaped.