You Have the Empathy of a Goat

Keynote talk at RubyConf 2016 - Cincinnati

Transcript

1. Rosalie Gale Ugly Baby
4. You Have the Empathy of a Goat Documenting with the User in Mind Tara Scherner de la Fuente @MediaRemedial
5. The User & Documentation
8. The Curse of Knowledge
11. Finding the User Stories
13. Copyright 2015 GROK – Susanne Kappler
14. # validating with case insensitivity with # AR 2.3.5 uses SQL lower(), # which clubs baby seals and crashes sites # this method is an attempt to validate uniqueness # bypassing SQL lower() by leveraging the default # mysql behavior of nonbinary string comparison
15. Explain the Why
16. Image: Sundeep Gupta FLUFF
17. Demonstrate a goat message less than 50 characters Then we’ll use the body to explain what and why. For example, good commit messages are documented so many places! But folks either don’t know that, or they don’t give a goat’s ass. To correct this, we’re giving this talk. It might be useful to discuss why the solution is being implemented this way instead of other ways. - git-scm.com/book/en/v2 is Git Pro (free) - Issue #GOAT42 gitgoat.com/secret/issues/goat42
18. git commit –m “short form” BEFORE (what style): Demonstrate a goat message. AFTER (why style): Enable user to write informational goat message
19. Demonstrate a goat message less than 50 characters Then we’ll use the body to explain what and why. For example, good commit messages are documented so many places! But folks either don’t know that, or they don’t give a goat’s ass. To correct this, we’re giving this talk. It might be useful to discuss why the solution is being implemented this way instead of other ways. - Paired with @wisetara and @kerrizor - git-scm.com/book/en/v2 is Git Pro (free) - Issue #GOAT42 gitgoat.com/secret/issues/goat42
21. It’s Hard to Write with Hooves
26. Profit
28. - Fixed: Links with “&” in the url were being converted to contain “&” when opening or copying. They now work perfectly each & every time.
29. @ericholscher inspired this slide