Since the beginning, the Teach Better Podcast has included pretty good show notes along with our episodes. This has mostly been the work of my cohost Edward O’Neill, who also handles all our audio production. In these notes, we provide references and links to resources we mention in our conversations. We also break every episode into 5-10 minute chunks and give you a rough sense of the content of each. As of today that these chunks are individually playable from the website!
Now, when you’re looking at the show notes for our conversation with mathematician Steven Strogatz and his discussion of eigenvectors at 52:27 piques your interest, you can immediately play it. And when you want to know how Don Kagan was inspired by Otto von Bismarck at 44:58 (one of my all time favorite moments), you just press the play button. And you can now go straight to the part of our conversation with Laurie Santos (9:32) where she talks about teaching “Sex, Evolution, and Human Nature” in Yale’s Battell Chapel. I’ve had great fun digging around in our old episodes, and I encourage you to try out this new way to interact with our archive. And keep in mind that we’re not done–This is just the first step toward truly unlocking our podcast archive.
Most readers of this site won’t be interested in the implementation details, but I’m going to provide some in hopes that other podcasts will be inspired to provide the same feature. The first step was to put all our show notes into a standardized format that we can automatically translate into HTML. We’ve chosen to use YAML as it is easy to create in a text editor and process with code (in our case Ruby). Here’s the beginning of the YAML for our conversation with Steven Strogatz:
episode: 45 podcast: tbp-episode-45.mp3 chunks: - start: 0:00:00 end: 0:00:42 tags: description: | Intro - start: 0:0:42 end: 0:01:20 tags: description: | Welcome Steven! * [The Calculus of Friendship: What a Teacher and a Student Learned about Life while Corresponding about Math](https://www.amazon.com/Calculus-Friendship-Teacher-Student-Corresponding/dp/0691150389) * [Sync: How Order Emerges from Chaos in the Universe, Nature, and Daily Life](https://www.amazon.com/Sync-Order-Emerges-Universe-Nature/dp/0786887214) * [The Joy of x: A Guided Tour of Math, from One to Infinity](https://www.amazon.com/Joy-Guided-Tour-Math-Infinity/dp/0544105850) - start: 0:01:20 end: 0:02:40 tags: description: | No such thing as [an original idea](https://www.amazon.com/Joy-Overview-Window-System-2nd/dp/0201565129); Kids these days don’t get all [our jokes](https://en.wikipedia.org/wiki/The_Brady_Bunch)
Now that we are letting listeners jump around between specific spots in our episodes, we have to encode our audio files as Constant Bit Rate (CBR) mp3’s. That’s because the audio libraries built into iOS and macOS don’t seek accurately in the alternative, Variable Bit Rate (VBR) mp3’s. As Marco Arment points out in his plea for Apple to fix this, it’s a real shame since VBR’s are smaller and sound better.
Very few podcasts use Octopress and thus can copy our code wholesale. That said, I think (hope) it would be pretty easy to translate this to Wordpress or Squarespace or whatever else other folks are actually using. As a frequent podcast listener, I hope at least some of my favorite podcasts do.