Minor cleanup of YAML Syntax documentation

Fixed some typos, updated some indentation, and reworded a few sentences.