Published: Aug. 19, 2020, 9 a.m.
b'
02:26 - Aisha\\u2019s Superpower: Proofreading
\\n\\n
04:05 - Documentation
\\n\\n
\\n- \\u201cThe Code Documents Itself\\u201d
\\n- Context / Entry Points
\\n- Documentation as a Narrative
\\n- The Value of Documentation
\\n
\\n\\n
07:54 - Forms of Documentation Worth Investing In
\\n\\n
\\n- Onboarding
\\n- Commit Messages
\\n- Pull Requests
\\n
\\n\\n
10:34 - Architecture and Stories
\\n\\n
\\n- Commit Messages
\\n- References
\\n- User Stories
\\n
\\n\\n
17:17 - Telling Stories Through Documentation
\\n\\n
\\n\\n
23:37 - Defining Documentation
\\n\\n
26:17 - Making Documentation Accessible & Approachable
\\n\\n
\\n- Requires Empathy
\\n- Collaboration
\\n- Constructing Shared Common Ground
\\n
\\n\\n
33:33 - Giving Constructive Feedback
\\n\\n
\\n\\n
44:37 - self.conference: Focusing on Human Aspects in Technology
\\n\\n
48:49 - Technology is NOT Neutral
\\n\\n
\\n- Moral Responsibility
\\n- The Things We Build Have Impact
\\n- Inclusion and Exclusion
\\n
\\n\\n
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
\\n\\n
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:
- 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. \\n\\nHoneybadger 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.\\n\\nHoneybadger 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.\\n\\nThe 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.\\n\\nGo 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.\\n\\nGreater 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.\\n\\nManaging your remote team as they work from home? Managing a gazillion SSH keys, database passwords, and Kubernetes certs?\\n\\nMeet strongDM. Manage and audit access to servers, databases, and Kubernetes clusters, no matter where your employees are.\\n\\nWith 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.\\n\\nAdmins 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.\\n\\nstrongDM is used by companies like Hearst, Peloton, Betterment, Greenhouse, and SoFi to manage access. It\'s more control and less hassle.\\n\\nstrongDM. Manage and audit remote access to infrastructure.\\n\\nStart your free 14-day trial today at strongdm.com/SDT\\n
- 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?\\n\\nPaul 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.\\n\\nThis 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.\\n\\nIn 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.\\n\\nOnce again to get 20% off your ticket, visit virtualgenious.com/events and use the code VGGTC. Promo Code: VGGTC
Support Greater Than Code
'