fixed descriptions

Previously, the descriptions were invalid YAML; block text needs to be
noted and indented in YAML.