The B2B Podcast Index
Index
All categories
MarketingSalesSaaSFinanceHROpsLeadershipCustomer SuccessAI & DataProductStartups & FoundersRevOpsEngineering & DevTools
MethodologySubmit
Best of:MarketingSalesSaaSFinanceHROpsLeadershipCustomer SuccessAI & DataProductStartups & FoundersRevOpsEngineering & DevTools
An independent project byFame
SearchBest episodesGuestsInsightsMethodologySubmit a podcast
Index/Product/Knowledgebase Ninjas
Knowledgebase Ninjas artwork

Balancing Graphics and Text in Technical Docs - James Birkinshaw, Oracle

Knowledgebase Ninjas · 2025-04-30 · 20 min

0:00--:--

Topics in this episode

Technical writingDocumentationgraphics

Episode notes

In this episode of Knowledge Base Ninjas, we have James Birkinshaw, Principal Technical Writer at Oracle. He shares his unique journey into technical writing, starting from drafting and design to discovering his passion for clear communication. Inspired by the book How to Keep Your Volkswagen Alive for the Complete Idiot, James combined his interests in writing, computer science, and design to build a successful career. He highlights the critical role of understanding your audience before writing and emphasizes that illustrations should complement, not replace, the text. James discusses how a thoughtful balance between visuals and text creates more impactful documentation. He also touches on the role of AI in technical writing, noting that while AI can enhance efficiency, human writers remain essential for ensuring accuracy and clarity. Additionally, he emphasizes the importance of designing scalable graphics, keeping internationalization and localization in mind. The episode offers practical advice, real world insights, and thought-provoking conversations about the evolving relationship between visuals and technical documentation.

Related episodes across the Index

Other episodes covering the same guests and topics, from across The B2B Podcast Index.

  • AI As Your Writing PartnerThe Future of Work · on Technical writing64 / 100
  • Product Ops: The 4 Foundations of Strategic PartnershipProduct Team Success · on Documentation46 / 100
  • The Design Documentation No One Asks For (But Everyone Needs)Product Management Tech Brief By HackerNoon · on Documentation
  • Doist COO Allan Christensen on remote ops, perfecting hiring, designing ops for career development, the ideal employee feedback loopBetween Two COO's with Michael Koenig · on Documentation
  • Spreadsheets rule the world 📊 David Lyford-Smith, Spreadsheet WarriorsGet Together · on Documentation

More from Knowledgebase Ninjas

All episodes →
  • Writing Clearly in the Age of AI: Lessons from Stripe’s Ryan Young65 / 100
  • From Python to Technical Writing: A Cloud-Native Documentation Journey with Michael Uzukwu62 / 100
  • Will AI Replace Technical Writers? The Future of Docs with Steev Kundukulangara75 / 100
  • Technical Writing Leadership in the Age of AI - with Ramesh Aiyyangar, TechWritePro59 / 100
  • From Developer to Tech Writer: How AI, Empathy & Localization Shape Modern Documentation51 / 100
Explore the best B2B Product podcasts →
All Knowledgebase Ninjas episodes →