If we generate yamllint compatible YAML out of the box, this will help with user adoption, consistency, and support requests. We can ask users to ensure that their yaml first passes yamllint, ensuring we are starting from a place of validity. Between code editor extensions or just running it locally, its an extremely useful tool to ensure consistency close to the user. We could have ruamel generate yamllint compatible yaml by: self.yaml.explicit_start = True self.yaml.indent(mapping=2, sequence=4, offset=2) This will indent arrays the way yamllint expects and add a --- header.