196: Documentation as Performance with Aisha Blake

02:26 - Aisha’s Superpower: Proofreading 04:05 - Documentation * “The Code Documents Itself” * Context / Entry Points * Documentation as a Narrative * The Value of Documentation 07:54 - Forms of Documentation Worth Investing In * Onboarding * Commit Messages * Pull Requests 10:34 - Architecture and Stories * Commit Messages * References * User Stories 17:17 - Telling Stories Through Documentation * Documentation as Performance * < title of conf > (https://www.titleofconf.org/) * Tail Call Optimization: The Musical!! by Anjana Vakil & Natalia Margolis (https://www.youtube.com/watch?v=-PX0BV9hGZY) 23:37 - Defining Documentation 26:17 - Making Documentation Accessible & Approachable * Requires Empathy * Collaboration * Constructing Shared Common Ground 33:33 - Giving Constructive Feedback * Feedback Requires Consent * Interviewing for Interpersonal Skills That Are Required to Give Good Feedback * “Tell me a story…” / Roleplaying * Give Feedback Fearlessly – Aisha Blake (https://www.youtube.com/watch?v=wsoh_EDE9Xc) 44:37 - self.conference (https://selfconference.org/): Focusing on Human Aspects in Technology 48:49 - Technology is NOT Neutral * Moral Responsibility * The Things We Build Have Impact * Inclusion and Exclusion This episode was brought to you by @therubyrep (https://twitter.com/therubyrep) of DevReps, LLC (http://www.devreps.com/). To pledge your support and to join our awesome Slack community, visit patreon.com/greaterthancode (https://www.patreon.com/greaterthancode) To make a one-time donation so that we can continue to bring you more content and transcripts like this, please do so at paypal.me/devreps (https://www.paypal.me/devreps). You will also get an invitation to our Slack community this way as well. Special Guest: Aisha Blake.