CONFIGURATION FILES ARE USER INTERFACES

Summary from the TLDR Web Dev newsletter

Configuration files should be treated as user interfaces with a focus on excellent user experience, moving beyond simply choosing a configuration language. The common industry practice of accepting poor configuration experiences is bad, especially because YAML's deceptive simplicity leads to complex maintenance issues. KSON is a new open-source project that is an example of a language designed with user-friendly configuration in mind, with advanced editor support and a focus on human readability.