For someone reason (nostalgia?) I've been re-visiting Donald Knuth's concept of Literate Programming.
(For a quick intro, critique and discussion on this approach see this blog entry and the responses.)
I first discovered Literate Programming via looking at TeX sources in the 1980s. Then I became somewhat obsessed with the approach around 1992 with the publication of Literate Programming by Knuth. This is still one of my favorite books on programming.
I still like to thumb through TeX: The Program (likely the largest Literate Program ever written).
Perhaps I am starting to revisit Literate Programming because of my full-time-deep-dive into embedded programming (again). Still stuck with C and code that is supposed to work (I deal more with "firmware" than software these days -- code that can't just be frequently updated, is hard to unit test and must be very, very reliable).
Literate Programming doesn't fit well in today's rapid development, big team, fastest-time-to-market culture. But, when I am writing control systems with little instructional software/literature available (e.g. learning how to spin a BLDC motor using sinusoidal waves), I start thinking about approaching it in a literate style.
Shhh... don't tell my partners, but I am definitely thinking about using cweb or perhaps cwebx for this ;)