Function parse 

pub fn parse(yaml: &str) -> Result<Spec>

Reads a spec from YAML text, written in the format authors write (syntax).

Errors

Error::Invalid with every problem found, coded and placed (file names the spec file in their first line).