Noweb – A Simple, Extensible Tool for Literate Programming

I find that the order of diffs given by git is not optimized for helping a reviewer understand the change. Sometimes the order of files will not be in the most logical way; sometimes unrelated changes (e.g., a text editor removing blanks at the end of lines) create noise; etc.

I've been thinking that it would be interesting to have a tool where the author can take the diff of their commit(s), order them in a way that is conducive to understanding and explain each part of the diff. That'd be similar to having the author do a code walkthrough, but at the pace of the reader rather than the author.

https://martinfowler.com/bliki/SemanticDiff.html

Tools in this space date back to the 1990s. There is a recent upsurge of interest, a number of capable tools for different languages are currently available.