196: Documentation as Performance with Aisha Blake
August 19th, 2020 · 55 mins 24 secs
About this Episode
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 >
- Tail Call Optimization: The Musical!! by Anjana Vakil & Natalia Margolis
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
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.
Support Greater Than CodeEpisode Sponsors
-
Honeybadger Let's face it, your code is going to have errors, even code written by a kick-ass developer such as yourself. When bad things happen, it's nice to know that Honeybadger has your back.
Honeybadger makes you a DevOps hero by combining error monitoring, uptime monitoring, and chron monitoring into a single, easy to use the platform, all for way less than you're probably paying now.
Honeybadger monitors and sends error alerts in real-time with all the context needed to see what's causing the error and where it's hiding in your code so you can quickly fix it and get on with your day.
The included uptime and chron monitoring also let you know when your external services are having issues or your background jobs go AWOL or silently fail.
Go to Honeybadger.io and discover how Starr, Josh, and Ben created a 100% bootstrapped monitoring solution. Why is this important? Self-funding means they only answer to you, the developer, rather than a venture capital overlord.
Greater Than Code listeners get 30% off for 6 months. Simply mention Greater Than Code when signing up and they'll apply the discount to your account; no credit card required.
-
strongDM Today's show is sponsored by strongDM.
Managing your remote team as they work from home? Managing a gazillion SSH keys, database passwords, and Kubernetes certs?
Meet strongDM. Manage and audit access to servers, databases, and Kubernetes clusters, no matter where your employees are.
With strongDM, easily extend your identity provider to manage infrastructure access. Automate onboarding, offboarding, and moving people within roles. Grant temporary access that automatically expires to on-call teams.
Admins get full auditability into anything anyone does: when they connect, what queries they run, what commands are typed. It's full visibility into everything. For SSH, RDP, and Kubernetes, that means video replays. For databases, it's a single unified query log across all database management systems.
strongDM is used by companies like Hearst, Peloton, Betterment, Greenhouse, and SoFi to manage access. It's more control and less hassle.
strongDM. Manage and audit remote access to infrastructure.
Start your free 14-day trial today at strongdm.com/SDT
-
Virtual Genius Collaboration between different disciplines in your organization can be difficult, and finding clarity and alignment on both the right problem to solve and the right solution design is even more so. We each approach improvement from our own (limited) perspective, without taking into account the whole story. How is that effective?
Paul Rayner's EventStorming Facilitation Virtual Workshop is a multi-day online event that promotes collaboration between different disciplines in order to solve business problems in the most effective way.
This virtual workshop with Paul consists of 4 sessions on Sep 28-Oct 1 from 9am-Noon (CDT) each day. To register and get 20% off your ticket, visit virtualgenious.com/events and use the code VGGTC.
In this highly hands-on and interactive virtual workshop you'll learn advanced EventStorming facilitation skills spanning from large scale business discovery to collaborative solution design at the team level.
Once again to get 20% off your ticket, visit virtualgenious.com/events and use the code VGGTC.