Hacker News Reader

I really really really wish there was a website that broke down code like this into explained text. I can grok a lot of code regardless of language somewhat intuitively because there is so much crossover - but I still have issues often when it comes to breaking down complex and unique segments.

This would really help the learning process but I appreciate how time intensive it is.

View on HN

Have a look at literate programming (I think that's what it's called). It's not exactly what you're looking for (in that the project must be done that way from the beginning) but you'll find it interesting I think!

That is what it's called. A site [1] with some examples. Donald Knuth developed the term and concept. It seems fairly popular in the haskell community, and to a lesser extent the scheme/racket communities.

[1] http://en.literateprograms.org/LiteratePrograms:Welcome

Yes, that would be a great place to find more like this. CoffeeScript has added support for literate programming, so that might be a good place to go for modern, web-oriented code samples.

Reply on news.ycombinator.com