This post has been written in two parts, The first part, slagging off about YAML, and YAML in swagger in particular (“the problem”), and The second part, presenting