There's a variation called "elucidative programming" [1] wherein the source is marked with "anchors" that the documentation can reference. Since source code li

There's a variation called "elucidative programming" [1] wherein the source is marked with "anchors" that the documentation can reference. Since source code lives in traditional source files, all the regular development infrastructure continues to work. When the source/documentation bundle is processed, the output is a two-pane coordinated view of code and discussion. [1] http://people.cs.aau.dk/~normark/elucidative-programming/ http://people.cs.aau.dk/~normark/elucidative-programming/