An engineer’s tips for writing documentation devs love
> "You'd be surprised how many people get turned off by seeing something that other people tell them is simple, and then it's not simple to them."<p>This. This should be every platform/infrastructure engineer's motto. Don't tell me <i>your DSL</i> is simple. Don't tell me that Puppet is so simple because oh my god, it uses Ruby. Don't tell me that HCL or terraform or whatever yaml crap is so simple because "they are in yaml". No. They are not.<p>Don't. Make. Me. Learn. It's not because I don't want to learn. It's because I want to learn fundamentals instead of your specific, non-generalizable, 6-month-or-less half-life stuff.