fix typo
Fix YAML headers for reference doc, and also general cleanup.