DEV Community

Greater Than Code

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

23:37 - Defining Documentation

26:17 - Making Documentation Accessible & Approachable

  • Requires Empathy
  • Collaboration
  • Constructing Shared Common Ground

33:33 - Giving Constructive Feedback

44:37 - self.conference: 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 of DevReps, LLC. To pledge your support and to join our awesome Slack community, visit 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. You will also get an invitation to our Slack community this way as well.

Special Guest: Aisha Blake.

Sponsored By:

Support Greater Than Code

Episode source