Document the YAML, remove some dead code, fix typos.