News for hackers. Stuff that matters.

A comment on Literate programming is much more than just commenting code. Parent comment

Re:Literate programming is much more than just commenting code by shakna on Tuesday March 22, 2022 @03:18AM (#30763463)
Refactoring becomes the dual problem space of both programming and editing.

It's simply more work - but that "more work" is vitally important, tedious, and resistant to any kind of automated help.

[ Parent | on HN ]
Re:Literate programming is much more than just commenting code by User23 on Tuesday March 22, 2022 @09:29AM (#30765822)
With Emacs org-babel I just do the refactor using the normal tools for whatever language on the tangled files and then detangle it back to the literate document. There's no problem here.
[ Parent | on HN ]
Re:Literate programming is much more than just commenting code by shakna on Tuesday March 22, 2022 @11:49AM (#30767548)
By "editing" I didn't mean editing the source. I meant the writing process, editing [0]. The thing you may hire an Editor to do. It is not something that you can automate, and the difficulty has very little to do with the tooling.

A slight change in code structure, may require many hundreds of adaptions to the literate document, for example.

[0] https://www.postgraduate.uwa.edu.au/__data/assets/pdf_file/0...

[ Parent | on HN ]