Why Is a Raven Like a Pull Request: What Writing Workshops Can Bring to Code Reviews

*

See this talk at Open Source Bridge 2017! Register today!

Accepted Session
Short Form
Beginner
Scheduled: Thursday, June 22, 2017 from 2:30 – 3:15pm

Excerpt

Many talks aimed at beginners to open source contribution assume that concepts like peer review and justification of intent are brand new. If you have ever experienced the thrills–and/or horrors–of a writing workshop, many ideas central to a successful pull request aren't that new at all. Let's talk about what experienced workshoppers and the field of writing critique can bring to your OS project.

Description

“(kill your darlings, kill your darlings, even when it breaks your egocentric little scribbler’s heart, kill your darlings)” – Stephen King, On Writing

Many talks aimed at beginners to open source contribution assume that concepts like peer review and justification of intent are brand new. If you have ever experienced the thrills–and/or horrors–of a writing workshop, many ideas central to a successful pull request aren’t that new at all.

As a senior engineer who mentors juniors as they learn how to review code effectively, I often indirectly reference my creative writing background. What should (or should not) be communicated along with a submission? How much is too much for a productive review session? As a reader, how much should you focus on the trees versus the forest?

Beginners and olds alike are invited to hang out with this former MFA-aspiring poet and listen to some ponderings regarding new ways to frame code contributions, particularly in the world of open source.

Speaking experience

Speaker, Open Source & Feelings 2016: http://confreaks.tv/videos/osfeels2016-standing-desks-and-free-pizza-body-image-negotiations-in-tech-spaces

Speaker