Literate Programming

[tg-x]

Literate programming is an interesting approach to make programs more easily understandable.

Anyone tried it before? Any opinions?

There are a number of tools that aim to facilitate this in a language-independent way:

• Literate (git): uses markdown with a vim plugin
  • a recent example using it is sud (git)
• Org-Babel: uses org-mode with emacs
• portia (git)

Question though is how to integrate it with editors nicely that do on-the-fly syntax checking and code completion.

[how]

I know Jaromil uses it quite a lot. Here’s a recent example: https://sud.dyne.org/

[tg-x]

yes that’s where i’ve seen it recently (also linked it above)

[pukkamustard]

I like org-mode/org-babel and have used it for demos/examples: examples/ipfs.org · main · openEngiadina / eris · GitLab or docs/demo.org · develop · openEngiadina / cpub · GitLab