Upgrade to Pro — share decks privately, control downloads, hide ads and more …

You Have the Empathy of a Goat

You Have the Empathy of a Goat

Keynote talk at RubyConf 2016 - Cincinnati

048a429ca5d4486ade2fc2bc19a67e0f?s=128

Tara Scherner de la Fuente

November 11, 2016
Tweet

More Decks by Tara Scherner de la Fuente

Other Decks in Programming

Transcript

  1. Rosalie Gale Ugly Baby

  2. None
  3. None
  4. You Have the Empathy of a Goat Documenting with the

    User in Mind Tara Scherner de la Fuente @MediaRemedial
  5. The User & Documentation

  6. None
  7. None
  8. The Curse of Knowledge

  9. None
  10. None
  11. Finding the User Stories

  12. None
  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
  20. None
  21. It’s Hard to Write with Hooves

  22. None
  23. None
  24. None
  25. None
  26. Profit

  27. None
  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

  30. None
  31. None