Brighton Ruby Conference 2018

2020

Just Simply

Emma Barnes // @has_many_books

Download

Emma wants to explain how trivial your work is, nowadays. After all, there are so many gems, libraries and frameworks that make your work as developers painfully simple, really obvious and frighteningly easy. All you have to do is just use them: they make programming painless!

Except she won’t. Expanding on her justsimply.dev manifesto, Emma will share some of the most egregious examples of technical documentation that infuriate rather than help. And she’ll provide useful advice to keep your technical writing friendly, supportive and impactful.

And yes. All the phrases in the first paragraph are from real world documentation. By the end of this talk you’ll have resolved not to put people off using the code you’ve worked so hard to create. Because if someone’s having to read your docs, it’s not “simple”.

Followed up with a podcast chat

Friday, 3rd July 2020