Where can I listen to this podcast?

This podcast is available on 4 platforms including Apple Podcasts, Spotify, and more. You can also use the RSS feed directly.

Does this podcast accept guests?

Yes, this podcast regularly features guests.

Hartley's Handbook

Claim This Podcast

by by Hartley

11 episodes

Updated Weekly

Accepts GuestsHas Sponsors

Podcast Authority

Beta

PoorBased on show quality, social media presence, reviews, charts, and more

Quality41

Social0

YouTube0

Engagement0

Learn more

Podcast Overview

This is an advice podcast for engineers of all experience levels, tech leaders, and anyone navigating the tech-adjacent world. With over 15 years in the industry, I’m here to answer your questions, share insights, and offer guidance to help you tackle the challenges of your day-to-day. Let’s dive in and make your tech journey a little smoother! No vapid quotes and no B.S. here, just tactical advice that you can implement immediately. <a href="https://hartleyshandbook.com?utm_medium=podcast">hartleyshandbook.com</a>

Language

🇺🇲

Publishing Since

11/29/2023

Visit Website View on Apple Podcasts RSS Feed

🇺🇸 Charts #3

Outreach generated

Apple 142

Spotify 827

Instant mention tracking

Perfect fit!

Unlock The Full Podcast Authority Score Report

See how your podcast performs across key metrics

Podcast Authority

Beta

PoorBased on show quality, social media presence, reviews, charts, and more

Quality41

Social0

YouTube0

Engagement0

Learn more

Excellent Areas

Good Performance

Growth Opportunities

excellent

Episode Length

29 minutes

Performing excellently!

good

iTunes Tags

6.5/10

Recommendations available

Unlock the full report to see detailed tips

poor

Publishing Consistency

Every 41 days

Recommendations available

Unlock the full report to see detailed tips

+16 More Metrics

Unlock comprehensive insights including:

• YouTube presence analysis
• Social media reach metrics
• RSS compliance scoring
• Podcast 2.0 features
• Technical standards

What's Included in Your Full Report

Detailed Analytics

Complete breakdown of all 19 authority metrics
Personalized recommendations for each metric
Industry benchmarks and comparisons
Technical RSS feed analysis and compliance scoring

Growth Strategies

Step-by-step action plans for improvement
Quick wins to boost your score immediately
Pro tips from successful podcasters

Get your free podcast insights report

See how your show performs across every key metric

Instant delivery

No spam

Attract Better Guests

High authority scores make your podcast more attractive to industry leaders and influencers who want to appear on credible shows.

Secure Sponsorships

Sponsors look for podcasts with proven authority and engagement. Your score demonstrates your podcast's value to potential partners.

Grow Your Audience

Understanding your strengths and weaknesses helps you make data-driven decisions to expand your listener base effectively.

1 verified contact email on file for Hartley's Handbook

Pitch yourself as a guest, propose sponsorships, or reach out directly to the host.

See contact details

Recent Episodes

February 26, 2025

#8 Documentation and the Council of Elders

From an environment perspective, having solid documentation supports stability and productivity. So let’s tackle a tough question: What makes good documentation?First off, there's no such thing as perfect documentation—just like there's no perfect code. The key is producing and maintaining it consistently. Documentation requires a different thought process than coding; it's more creative and explanatory.AI Summary provided by <a target="_blank" href="https://audiopen.ai?aff=XK1wX">Audiopen.ai</a>, the only AI tool I pay for (<a target="_blank" href="https://audiopen.ai?aff=XK1wX">affiliate link</a>)This brings me to the Diataxis framework. It categorizes documentation into four types: how-to guides (practical steps for tasks), tutorials (learning-based steps), references (quick look-ups for APIs), and explanations (theoretical understanding). This framework helps determine what kind of documentation is needed based on its purpose.Diataxis helps organize information but doesn’t dictate where it should live—that's up to each organization. It’s like agile processes; each team adapts it to their needs.So does Diataxis provide insight into organizing documentation?Not directly; it focuses more on categorizing content rather than structuring it within an organization. Each team must figure out their own system based on their dynamics.You mentioned implementing a documentation council at work. How does that function?Our council consists of representatives from each feature team who audit existing documentation and handle requests for new docs or updates. We meet periodically to review what we have and what’s needed, creating tickets for updates or new documents as necessary.When someone requests documentation, how does that process look?We kick off audits once every quarter or six months, review existing docs for relevance and accuracy, then create tickets for necessary updates or new documents based on feedback from teams.In fast-paced environments like Dynamit, how would you implement such practices?It’s challenging but crucial to allocate time for documentation even in fast-paced settings. Managers need to push for this time allocation while developers should embrace professionalism by thinking about future maintainers of their code.How do you balance code comments versus external documentation?Consider who will consume your code: API layers need explicit docs while feature teams might need detailed comments within the code itself. Capture feedback during onboarding to continuously improve your process.If you don’t have a council yet, where do you start?Start small by identifying passionate individuals who care about clarity in their work. Give them responsibility over documentation as part of their career growth trajectory—it’s low stakes but high impact.Thanks for sharing these insights, Michael!It's not something your end user will see, but it provides juniors and mids with tangible tasks to demonstrate leadership abilities. For others, it's an opportunity to improve things, which is a common goal. Junior engineers, curious about the code and still learning, might notice a lack of documentation. They could spend a day or two diving in, understand it, and present their findings to the team.I've noticed a trend in organizations heavy on Slack or Teams using video for documentation. Tools like Loom allow for recording changes and explanations. Historically, we preferred written documentation as a contract with everyone. However, long documents can be overwhelming. A five-page document feels like a wall of text; even I struggle with comprehension without multiple reads. TLDRs help in understanding the core quickly.Videos as documentation are great but come with challenges. Tech talks at our organization contain valuable information, but making them accessible and searchable is tough. Tools like Microsoft Stream offer solutions by uploading videos, generating transcripts using AI, allowing comments, and deep linking to specific sections. This makes videos searchable and collaborative.AI tools are evolving to assist in documentation. Tools that grok APIs and generate documentation or transcribers like Otter that take meeting notes are helpful. AI tools can retrieve information efficiently but should be used cautiously for generating content.The industry's direction seems to favor tools like Microsoft Stream becoming more available. Properly cultivated video documentation can be as essential as written docs for quick reference and communication.As for AI tools in documentation, they can create knowledge bases isolated from the public domain. Integrations with platforms like Confluence make information retrieval easier. However, I caution against relying on AI for generating content; it's better suited for retrieval.While AI can cover up issues instead of fixing them, we must scrutinize its output rigorously. Use AI as a tool without letting it replace human judgment.Documentation is an investment for the future and those who will replace you eventually. For new engineers, taking extensive notes while learning can form useful documentation later. It's about professionalism and continuous improvement—start small, iterate, and build a documentation culture.In summary: dedicate time to documentation, use frameworks like Diataxis for guidance, leverage AI as a tool (not a replacement), and focus on continuous improvement.For further questions on documentation, I'm available on LinkedIn. This is a public episode. If you would like to discuss this with other subscribers or get access to bonus episodes, visit <a href="https://hartleyshandbook.com?utm_medium=podcast&utm_campaign=CTA_1">hartleyshandbook.com</a>

February 12, 2025

#7 Balancing Code & Leadership + The Power of Sponsorship & Recognition

Welcome back to Ask Hartley Anything, the podcast where I tackle your questions and share lessons from my journey as an engineering leader. This is episode seven, and today we’re diving into two topics that are close to my heart. First, how do you manage your time and yourself when you're a manager expected to code? Second, sponsorship and recognition in leadership—how do you sponsor and recognize your team members effectively?Summary provided by <a target="_blank" href="https://audiopen.ai/?aff=XK1wX">AudioPen Prime</a>, the only AI tool I pay for. Goes from audio thoughts to transcribed summaries in whatever style you’re looking for. Love using this for long drives or walks.Before we jump in, remember you can always go to <a target="_blank" href="https://askhartley.com">askhartley.com</a> to submit your questions anonymously or with your name. I love working through these questions because management is something you learn by doing, often impacting those around you. So thinking through these scenarios helps prepare for when they arise.Let's start with balancing coding and leadership as a manager. Imagine you're a front-end lead managing four people while still expected to contribute to projects. You might think a 50-50 split between management and coding will work, but it's not that simple. The context switching between coding and managing is vastly different. Coding problems are direct—either it works or it doesn’t. People problems are nuanced; solutions may take months to reveal their effectiveness.So don't expect a strict 50-50 split. Priorities shift weekly; some weeks require more focus on individuals, others on code. The urgency also differs—a critical bug needs immediate attention, while a personal issue with a team member requires empathy and understanding.Next, consider perception and expectations. Your team expects you to stay technical while leadership wants you focused on strategy. As an individual contributor, your job was to write and deliver code. As a manager, you're expected to see further ahead, strategizing across teams and projects.Balancing these roles is tough, especially if it’s your first time managing. Strategy and people problems will be new territory, taking longer at first—and that’s okay. Here are some strategies that worked for me:* Time Blocking: It didn’t work well for me because interruptions are inevitable in management roles. If you try this, be very clear with everyone about your availability during these blocks.* Prioritize Value: Focus on smaller tasks that add value without becoming bottlenecks for your team. Let them handle complex issues requiring deep thought.* Delegate and Coach: Shift from execution to coaching. Delegate critical tasks but stay involved through PR reviews and architectural decisions without being the sole decision-maker.* Set Boundaries: Communicate clearly about when you'll be heads-down coding versus available for team issues.Remember, as a manager who codes, your role is about multiplying the team’s effectiveness—not just executing tasks yourself.Now onto our second topic: Sponsorship and recognition in leadership...Strong sponsorship increases retention, morale, trust, fairness, and encourages diverse leadership growth.Your success as a leader isn’t just about what you accomplish—it’s about who you elevate along the way.On sponsorship and recognition, it's about elevating others and strengthening both individuals and the organization. Put them in the spotlight, amplify their voices, and ensure they're heard even if they’re quiet.Moving on to sponsorship and recognition in leadership: Recognition drives engagement, retention, and career growth because it shows what behaviors are rewarded. Sponsorship helps underrepresented employees advance by putting them in visible positions.There’s a difference between sponsorship and mentorship—mentorship offers advice; sponsorship actively advocates for someone's career growth by giving them opportunities for visibility.Here are some practical ways to sponsor as a leader:* Public Credit: Acknowledge team members' work in meetings or updates without taking credit yourself.* Create Visibility Opportunities: Pull team members into decision-making meetings or let them present topics they’re experts in.* Push for Promotions/Raises: Document their impact consistently so it’s easy to advocate for them during promotion cycles.* Assign Stretch Projects: Give high-potential employees critical projects to build their credibility.* Celebrate Day-to-Day Wins: Regularly highlight both big achievements and small improvements in team communications.So, how do you balance leadership and coding? Who has sponsored you, or whom have you sponsored in your career? Share your thoughts at askhartley.com or message me on LinkedIn.That wraps it up for today. Next week, we'll have Michael Yodiv, a colleague of mine, discussing documentation. If you have questions about documentation in current, previous, or future organizations, drop me a note at AskHarley.com. We'll answer them live in a rapid-fire session—it’s going to be fun! That's all for Episode 8 next week. Thanks for listening. Have a great week! This is a public episode. If you would like to discuss this with other subscribers or get access to bonus episodes, visit <a href="https://hartleyshandbook.com?utm_medium=podcast&utm_campaign=CTA_1">hartleyshandbook.com</a>

January 29, 2025

The Balance Between Ambition and Self-Compassion

Welcome back to Ask Hartley Anything, episode six. I'm your host, John Hartley, and every week I take your questions and share insights from my journey as an engineering leader. Today, we're diving into a topic that's close to my heart: giving yourself grace. This means allowing yourself room to breathe, not being overly critical or pushing yourself too hard. It's something I've struggled with for a long time, and while I'm still working on it, I hope to shed some light on the subject. Maybe you're grappling with this too, and we can work through it together.Summary provided by <a target="_blank" href="https://audiopen.ai?aff=XK1wX">AudioPen Prime</a>, the only AI tool I pay for. Goes from audio thoughts to transcribed summaries in whatever style you’re looking for. Love using this for long drives or walks. Today, we'll explore why we push ourselves so hard, how it affects us, practical strategies for balancing ambition with self-compassion, and the long-term benefits of permitting yourself to rest and recover. If you've ever felt like you're not doing enough, this episode is for you. Even getting this episode out was a struggle for me—I debated whether to push myself or take a break. But I committed to releasing episodes weekly this year, so here we are. Burnout is an issue we face daily, so let's dive in. Why do we feel this way? Why do we push ourselves too hard? Much of what I'll share comes from my own experience. For instance, I ran a hot sauce company on the side while managing my day job and personal life. It was exhausting and led to burnout.The culture of overwork is finally starting to fade away, but hustle culture still lingers. Social media often glorifies constant productivity—early mornings, cold plunges, 10-mile runs before breakfast. This lifestyle can make us feel inadequate if we're not doing the same.This year, I've switched to audiobooks instead of stressing about reading physical books quickly enough. Oddly enough, manga like Berserk keeps my attention better than traditional books.Why do we push ourselves? Fear of failure and imposter syndrome play a big role. Early in my career at a digital agency, I pushed myself so hard that I got stress-induced shingles twice. The fear of being seen as a failure or unreliable drove me to overwork.This self-imposed pressure is something I've reflected on for years. We often equate more effort with more success, but sometimes stepping back is the most productive thing we can do.Think about where you're being hard on yourself and why. Are you pushing too far? In engineering leadership, I promote work-life balance heavily. If someone hasn't taken time off in a while, I encourage them to do so—not because they're doing a bad job but because they need to take care of themselves.We've created a culture where we're always on, especially in tech. Some colleagues don't even have Slack on their phones—setting boundaries is crucial.Let's talk strategies for giving yourself grace:1. Reframe Your Mindset: What does success mean to you? For me, it used to mean climbing the corporate ladder as fast as possible. Titles aren't everything; they don't necessarily equate to impact or satisfaction.2. Perfectionism: Are you trying to be perfect or good enough? Be okay with 80%. Perfection isn't realistic; aim for progress instead.3. Set Boundaries: Define clear working hours and stick to them. Use tools like Google Calendar and Slack notifications wisely.4. Practice Self-Compassion: Talk to yourself like a friend would—replace criticism with kindness and encouragement.5. Acknowledge Wins: Keep track of your accomplishments, even small victories—they build momentum and positivity.Lean on your network when you're struggling—having a hype person can make all the difference. And if you're still finding it tough, seeking professional help is okay too.Understanding your boundaries and relationships is critical as you navigate your career. Reflecting on your progress regularly helps maintain balance and growth.So think about what makes you happy and gives you joy in life. Give yourself some grace and set boundaries that work for you.Pushing yourself too hard generally leads to burnout rather than success. Reframe what success means for you—prioritize what matters most.What's one thing you'll give yourself grace with this week? I'd love to hear your thoughts—reach out at askharley.com or connect with me on LinkedIn.Thanks for listening! We'll be back next week with episode seven—possibly discussing documentation in engineering organizations with a special guest!Until next time, take care of yourselves! This is a public episode. If you would like to discuss this with other subscribers or get access to bonus episodes, visit <a href="https://hartleyshandbook.com?utm_medium=podcast&utm_campaign=CTA_1">hartleyshandbook.com</a>

11 total episodes available

Recent guests on Hartley's Handbook

Guests from recent episodes — sign up to see every guest that has ever appeared on this show.

Anonymous

Guest

Kyle

Guest

See every guest on Hartley's Handbook

Deep-dive analytics for Hartley's Handbook

Frequently asked questions

Have a different question and can't find the answer you're looking for? Reach out to our support team by sending us an email and we'll get back to you as soon as we can.

What is Hartley's Handbook?: This is an advice podcast for engineers of all experience levels, tech leaders, and anyone navigating the tech-adjacent world. With over 15 years in the industry, I’m here to answer your questions, share insights, and offer guidance to help you tackle the challenges of your day-to-day. Let’s dive in and make your tech journey a little smoother!

No vapid quotes and no B.S. here, just tactical advice that you can implement immediately. <a href="https://hartleyshandbook.com?utm_medium=podcast">hartleyshandbook.com</a>
How often does this podcast release new episodes?: This podcast updates weekly.
Where can I listen to this podcast?: This podcast is available on 4 platforms including Apple Podcasts, Spotify, and more. You can also use the RSS feed directly.
Does this podcast accept guests?: Yes, this podcast regularly features guests.

Legal Disclaimer

Pod Engine is not affiliated with, endorsed by, or officially connected with any of the podcasts displayed on this platform. We operate independently as a podcast discovery and analytics service.

All podcast artwork, thumbnails, and content displayed on this page are the property of their respective owners and are protected by applicable copyright laws. This includes, but is not limited to, podcast cover art, episode artwork, show descriptions, episode titles, transcripts, audio snippets, and any other content originating from the podcast creators or their licensors.

We display this content under fair use principles and/or implied license for the purpose of podcast discovery, information, and commentary. We make no claim of ownership over any podcast content, artwork, or related materials shown on this platform. All trademarks, service marks, and trade names are the property of their respective owners.

While we strive to ensure all content usage is properly authorized, if you are a rights holder and believe your content is being used inappropriately or without proper authorization, please contact us immediately at hey@podengine.ai for prompt review and appropriate action, which may include content removal or proper attribution.

By accessing and using this platform, you acknowledge and agree to respect all applicable copyright laws and intellectual property rights of content owners. Any unauthorized reproduction, distribution, or commercial use of the content displayed on this platform is strictly prohibited.