4 ms·
I love this idea (for digitalocean) of "documentation as marketing". Every time I read one of their articles, I feel like "oh wow their engineers must really kn
by solardev 4y ago
I love this idea (for digitalocean) of "documentation as marketing". Every time I read one of their articles, I feel like "oh wow their engineers must really know what they're doing, to be able to explain this so clearly". I didn't know they had a team of professional editors... kudos!
Another team that's really great at producing documentation is the Cloudflare retrospectives/postmortems folks, who can very clearly explain the cascading failures from complex systems.
I wish more devs/engineers wrote like that!
- edmundsauto 4y agoEditors are the key for any good writing. I've learned to assume that all good writing has a good editor/editing process, even if it's the author switching modes from creating to editing. David Sedaris writes amazingly well, and he says his "secret" is that every sentence has been edited and rewritten 19-20 times before it makes it into a book. One of the reasons documentation sucks is because we expect people to write well without editors.
- WalterBright 4y ago> David Sedaris writes amazingly well, and he says his "secret" is that every sentence has been edited and rewritten 19-20 times before it makes it into a book. I used to know some US ballroom dance champions. You'd think they'd spend their training time going over ephemera. Nope. It was all about taking a step. They never stopped going over how to take a step. It's the foundation for all dance. I love the ignorant phrase "they make it look effortless". Well, it is effortless when you've done it 10,000 times.
- SOLAR_FIELDS 4y agoMason, the guy the article is about, has some really good videos on DO. I learned a lot about several terraform best practices by watching him spin up a production cluster: https://www.digitalocean.com/community/tech_talks/building-a-minimal-production-ready-infrastructure-on-digitalocean https://www.digitalocean.com/community/tech_talks/building-a...
- deleted 4y ago[deleted]