Crafting and Editing In-Depth Tutorials at Real Python
Show notes
<p>What goes into creating the tutorials you read at Real Python? What are the steps in the editorial process, and who are the people behind the scenes? This week on the show, Real Python team members Martin Breuss, Brenda Weleschuk, and Philipp Acsany join us to discuss topic curation, review stages, and quality assurance.</p> <p>We start by sharing the multiple roles our panel of guests perform across the editorial process. They describe the phases a tutorial passes through, including layers of reviews, from technical accuracy to educational effectiveness. We also discuss our editorial independence, external authors, and the continuous feedback loop with our readers.</p> <p>This episode is sponsored by AgentField.</p> <div class="alert alert-primary" role="alert"> <p><strong>Spotlight:</strong> <a href="https://realpython.com/workshops/claude-code/">Claude Code Course: Stop Copy-Pasting From ChatGPT</a></p> <p>Most Python developers use AI as fancy autocomplete. This 2-day course teaches you to build entire projects with an AI agent inside your codebase.</p> </div> <p>Topics:</p> <ul> <li>00:00:00 – Introduction</li> <li>00:03:33 – Martin’s role at Real Python</li> <li>00:04:35 – Philipp’s role at Real Python</li> <li>00:05:27 – Brenda’s role at Real Python</li> <li>00:06:49 – Internal core team and external contributors</li> <li>00:13:46 – Selecting topics and subjects</li> <li>00:21:43 – Outlining and review</li> <li>00:28:26 – Sponsor: AgentField</li> <li>00:29:27 – Writing drafts</li> <li>00:34:03 – Changes to our style and format</li> <li>00:37:32 – Technical review and using Git</li> <li>00:43:53 – Didactic review</li> <li>00:52:59 – Language edit</li> <li>00:57:16 – Spotlight: Claude Code Live Course</li> <li>00:59:00 – Final QA</li> <li>01:01:00 – Scheduling</li> <li>01:03:36 – Reader feedback and updating existing tutorials</li> <li>01:06:04 – Using modern tools</li> <li>01:13:59 – Shining the light on contributors</li> <li>01:16:26 – Independence and editorial choices</li> <li>01:19:10 – Thanks and goodbye</li> </ul> <p>Show Links:</p> <ul> <li><a href="https://realpython.com/editorial-guidelines/">Editorial Guidelines – Real Python</a></li> <li><a href="https://realpython.com/team/">Meet Our Team</a></li> <li><a href="https://realpython.com/team/mbreuss/">About Martin Breuss</a></li> <li><a href="https://realpython.com/team/pacsany/">About Philipp Acsany</a></li> <li><a href="https://realpython.com/team/bweleschuk/">About Brenda Weleschuk</a></li> <li><a href="https://realpython.com/account/signup/?next=%2Faccount%2Fonboarding%2Fplan%2F&intent=learning_plan">Create Your Learning Plan</a></li> <li><a href="https://realpython.com/learning-paths/">Python Learning Paths</a></li> <li><a href="https://realpython.com/ref/">Reference – Real Python</a></li> <li><a href="https://realpython.com/jobs/">Join the Real Python Team – Real Python</a></li> <li><a href="https://realpython.com/live/">Cohort-Based Live Python Courses – Real Python</a></li> </ul> <p>Level up your Python skills with our expert-led courses:</p> <ul> <li><a href="https://realpython.com/courses/getting-started-claude-code/">Getting Started With Claude Code</a></li> <li><a href="https://realpython.com/courses/write-python-docstrings-effectively/">Write Python Docstrings Effectively</a></li> <li><a href="https://realpython.com/courses/python-basics-first-program/">Python Basics: Code Your First Python Program</a></li> </ul> <p><a rel="payment" href="https://realpython.com/join">Support the podcast & join our community of Pythonistas</a></p>
Guests
Analysis: done · source seed