I’d rate this as a story about the benefits of literate programming, and emacs org-babel is certainly best-of-breed for that. A more mainstream workflow for it might be through Jupyter notebooks, but they have several deficiencies compared to org-babel, chief of which is that one can’t present blocks out-of-order in Jupyter, but can do with org-babel-tangle. as far as I know, no literate-programming solution can pull code off disk and put it in a document (the anti-tangle direction), let alone update a doc when code is modified. It’s doable (start with git-actions, maybe?) but difficult. The lack of anti-tangle stopped my team from adopting literate programming as a collaboration tool, but it’s still great in the downward direction, i.e., from doc to code.
I’d rate this as a story about the benefits of literate programming, and emacs org-babel is certainly best-of-breed for that. A more mainstream workflow for it might be through Jupyter notebooks, but they have several deficiencies compared to org-babel, chief of which is that one can’t present blocks out-of-order in Jupyter, but can do with org-babel-tangle. as far as I know, no literate-programming solution can pull code off disk and put it in a document (the anti-tangle direction), let alone update a doc when code is modified. It’s doable (start with git-actions, maybe?) but difficult. The lack of anti-tangle stopped my team from adopting literate programming as a collaboration tool, but it’s still great in the downward direction, i.e., from doc to code.