Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

One approach to this is org-mode with babel.

You can have a plaintext file which is also the program which is also the documentation/notebook/website/etc. It's extremely powerful, and is a compelling example of literate programming.

Decent overview here: https://www.johndcook.com/blog/2022/08/02/org-babel-vs-jupyt...

[edit: better link]



I'm writing this comment as I write a literate README.org that documents and tangles a PoC program I'm writing for an upcoming big initiative at my job.

You can do most work in org instead of editing programs directly, and it'll save time and produce good documentation. Can't recommend it enough.

This approach has the recently developed benefit of being really great as context stores for interacting with LLMs.




Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: