TE
TechEcho
Home24h TopNewestBestAskShowJobs
GitHubTwitter
Home

TechEcho

A tech news platform built with Next.js, providing global tech news and discussions.

GitHubTwitter

Home

HomeNewestBestAskShowJobs

Resources

HackerNews APIOriginal HackerNewsNext.js

© 2025 TechEcho. All rights reserved.

Debuggable Explanations

3 pointsby judellover 2 years ago

2 comments

greg_wilsonover 2 years ago
Several people have asked "why not a Jupyter notebook?" There are several reasons, but one is that notebooks require each cell to be a runnable piece of code. For explanatory purposes, authors frequently want to show excerpts or snippets, e.g., a few lines from a function or one method from a class. There are ways to do this with notebooks, but they're all very clumsy.
judellover 2 years ago
The GitHub repo for the book includes all the text and all the code. I’d like to put them side-by-side, so that as I read the narrative I can run and debug the code that’s being described. Here’s how I’m doing that in VSCode.