Neat! I remember trying to use reveal.js to outline my codebase once 🙂 I think with voice over this extension could be quite useful. There were some youtubers trying to present complex projects like jquery but sadly that trend did not kick off. While this approach fixes code comprehension, literate programming solves the problem when such presentations and codebases go out of sync too.

True, the syncing part might not be as great compared to literate programming. From what I can tell, the extension works by annotating the Line of Code @ File. But the extension keeps track of code changes and updates the annotations accordingly. Simple.

An IDE for literate programming would be radically different, kinda like Scrivener which is used to write film screenplays. There’s also Leo editor. I think it is definitely high time for more tools like CodeTour that aim at code comprehension and not just code completion! It feels like intro.js but for code.

You could partially solve the problem of stale code locations by including git hashes in the location representations. Coupled with some visual indicator of how old a given line is in a tour, that helps readers/viewers gauge how much to trust the tour.