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

Comment with Compassion: Empathy, Open Source &...

Comment with Compassion: Empathy, Open Source & a Better World

by Rebecca Miller-Webster @rmillerwebster
and Tanner Welsh @tannerwelsh

Dev Bootcamp - 9 week intensive coding school
Make beautiful, meaningful things
NYC, Chicago, SF
@devbootcamp
devbootcamp.com

Rebecca Miller-Webster

January 18, 2014
Tweet

More Decks by Rebecca Miller-Webster

Other Decks in Programming

Transcript

  1. Comment with Compassion: Empathy, Open Source & a Better World

    Rebecca Miller-Webster @rmillerwebster [email protected] Tanner Welsh @tannerwelsh [email protected]
  2. Everybody can be great...because anybody can serve. You don't have

    to have a college degree to serve. You don't have to make your subject and verb agree to serve. You only need a heart full of grace. A soul generated by love.
  3. Open Source • New solutions & perspectives • Sharing, collaboration,

    & peer review • Exponential impact - multiplies knowledge, effort, inspiration & creativity
  4. 1. No greater service to non-tech 2. Low participation by

    minorities & women Issues with Open Source
  5. 1. No greater service to non-tech 2. Low participation by

    minorities & women 3. Assholes Issues with Open Source
  6. 1. No greater service to non-tech 2. Low participation by

    minorities & women 3. Assholes • Abrasive emails, flamewars, RTFM, etc Issues with Open Source
  7. 1. No greater service to non-tech 2. Low participation by

    minorities & women 3. Assholes • Abrasive emails, flamewars, RTFM, etc • Low documentation & user engagement Issues with Open Source
  8. People fail to get along because they fear each other;

    they fear each other because they don't know each other; they don't know each other because they have not communicated with each other.
  9. The difference between a tolerable programmer and a great programmer

    is not how many programming languages they know, and it’s not whether they prefer Python or Java. It’s whether they can communicate their ideas... By writing clear comments and technical specs, they let other programmers understand their code, which means other programmers can use and work with their code instead of rewriting it. Absent this, their code is worthless. By writing clear technical documentation for end users, they allow people to figure out what their code is supposed to do, which is the only way those users can see the value in their code. - Joel Spolsky
  10. Empathetic Open Source • Welcoming to new contributors • Respectful

    communication • Mentorship • Open Discourse
  11. We can m a k e o p e n

    source better! An individual has not started living until he can rise above the narrow confines of his individualistic concerns to the broader concerns of all humanity.
  12. • Commit messages • Pull request comments • README •

    Requests/response for help • Code Styleguides Feedback
  13. • Commit messages • Pull request comments • README •

    Requests/response for help • Code Styleguides • Chat in IRC Feedback
  14. • Commit messages • Pull request comments • README •

    Requests/response for help • Code Styleguides • Chat in IRC • Tests Feedback
  15. Feedback works! Rigorous inspections can remove up to 90% of

    errors from a software product before the first test case is run. Robert Glass Facts and Fallacies of Software Engineering Defect detection rates: unit testing: 25% integration testing: 45% design review: 55% code review: 60% Steve McConnell Code Complete
  16. • Code Quality • Knowledge Sharing • Teaching/Mentoring • Team

    Velocity • Collective Ownership Feedback makes us better
  17. It really boils down to this: that all life is

    interrelated. We are all caught in an inescapable network of mutuality, tied into a single garment of destiny. Whatever affects one destiny, affects all indirectly.
  18. We must remember that intelligence is not enough. Intelligence plus

    character-that is the goal of true education. The complete education gives one not only power of concentration, but worthy objectives upon which to concentrate.
  19. Power without love is reckless and abusive, and love without

    power is sentimental and anemic. Power at its best is love implementing the demands of justice, and justice at its best is power correcting everything that stands against love.
  20. Every man must decide whether he will walk in the

    light of creative altruism or in the darkness of destructive selfishness.
  21. •Be thorough & give yourself time •Focus on code not

    author Pull Requests & Code Review Action- able Kind Specific
  22. •Be thorough & give yourself time •Focus on code not

    author •Have a checklist Pull Requests & Code Review Action- able Kind Specific
  23. •Be thorough & give yourself time •Focus on code not

    author •Have a checklist •Run the code Pull Requests & Code Review Action- able Kind Specific
  24. •Be thorough & give yourself time •Focus on code not

    author •Have a checklist •Run the code •Sign off & hi-five! Pull Requests & Code Review Action- able Kind Specific
  25. CONTRIBUTING.md •How to set up & run code •Code styleguide

    •Channels for getting help or started •Suggestions for what to work on •Suggesitons for various skill sets •Code of conduct Action- able Kind Specific
  26. • Short summary for 1st line (50 chars) • Word

    wrap (72-80 chars) Commit Messages Action- able Kind Specific
  27. • Short summary for 1st line (50 chars) • Word

    wrap (72-80 chars) • One commit per change Commit Messages Action- able Kind Specific
  28. • Short summary for 1st line (50 chars) • Word

    wrap (72-80 chars) • One commit per change • Answer: Commit Messages Action- able Kind Specific
  29. • Short summary for 1st line (50 chars) • Word

    wrap (72-80 chars) • One commit per change • Answer: • Why is this change necessary? Commit Messages Action- able Kind Specific
  30. • Short summary for 1st line (50 chars) • Word

    wrap (72-80 chars) • One commit per change • Answer: • Why is this change necessary? • How does it address the issue? Commit Messages Action- able Kind Specific
  31. • Short summary for 1st line (50 chars) • Word

    wrap (72-80 chars) • One commit per change • Answer: • Why is this change necessary? • How does it address the issue? • What side effects does it have? Commit Messages Action- able Kind Specific
  32. • Short summary for 1st line (50 chars) • Word

    wrap (72-80 chars) • One commit per change • Answer: • Why is this change necessary? • How does it address the issue? • What side effects does it have? • Reference issues/bug and external links/ references Commit Messages Action- able Kind Specific
  33. No work is insignificant. All labor that uplifts humanity has

    dignity and importance and should be undertaken with painstaking excellence.
  34. Almost always the creative, dedicated minority has made the world

    better. Tanner Welsh @tannerwelsh Rebecca Miller-Webster @rmillerwebster