The Real Python Podcast Crafting and Editing In-Depth Tutorials at Real Python
21 snips
Mar 13, 2026 Martin Breuss, head of content strategy who curates topics; Philipp Acsany, course creator and recruiter for external authors; Brenda Weleschuk, editor focused on instructional clarity. They walk through topic selection, outlining, multi-stage reviews from technical checks to didactic edits, tooling and QA, and how reader feedback shapes tutorial updates.
AI Snips
Chapters
Transcript
Episode notes
Single Reviewer Shepherds Each Tutorial
- Real Python assigns a single core-team reviewer to shepherd each piece through multiple iterations.
- Philipp notes the reviewer handles outline review, technical review, and stays the author's contact across rounds to preserve intent.
Run Tutorials Like Code During Technical Review
- Treat technical review like a code review: run the tutorial steps, test code, and fix reproducibility issues.
- Philipp explains tutorials live in Markdown on GitHub so reviewers make line-by-line PR comments and validate accompanying project materials.
Do A Didactic Pass To Bridge Knowledge Gaps
- Do a didactic review to ensure concepts build logically and match learner intent before language edits.
- Brenda checks for unexplained jumps, missing bridges between concepts, and signals where complexity increases.