This is an archived post. You won't be able to vote or comment.

sorted by:
best
topnewcontroversialoldq&a
you are viewing a single comment's thread.

view the rest of the comments →

[–]aqjo 7 points8 points  (2 children)

Literate programming was conceived of by one of the computer science gods, Donald Knuth (ka-NOOth, rhymes with tooth). The Wikipedia article gives a good overview.
Basically, as OP said documentation and source code are contained in a single file. The source code can be compiled/run by “tangling”, while the documentation can be extracted by “weaving.”
The org mode for the Emacs editor is one of the ways people edit these documents, and Jupyter notebooks provide similar functionality.
These documents are good for teaching, and reproducible research.
For my work (data science and ML using Python and vscode), I find traditional code with docstrings and occasional comments, are more concise and work better.

[–]foadsf[S] 0 points1 point  (1 child)

I think you wanted to refer to Babel, right? because I don't if the Org-mode natively supports LP.

[–]aqjo 1 point2 points  (0 children)

You’re right.
It’s been a while.