9 ms·
As an example of literate programming, this is very well done, and the presentation is very pretty. With that said, it is not the ideal way (for me) to explain
by jonahx 4y ago
As an example of literate programming, this is very well done, and the presentation is very pretty.
With that said, it is not the ideal way (for me) to explain code. There is too much too read, even with the TOC. What I want, instead, is distillation. I want the energy spent on meticulous comments to be redirected into simplification and reduction -- still with a few well-chosen comments for support.
For comparison, even with 0 explanation, I can understand this 57 line hyperscript wordle (a language have almost no experience with):
https://arhamjain.com/hyperwordle/ https://arhamjain.com/hyperwordle/
much more quickly than I could read through the literate version. I understand the goals of each are not exactly the same, but I think both are trying to "clearly and efficiently communicate what the program is doing."
Perhaps a presentation of the literate version where I could suppress all the exposition and dig into it only as needed would help.
- wodenokoto 4y agoI think the power of literate programming is not so much the ability to explain the code as it is to explain the problem and how it was solved. In this case the problem is not “how to write wordle”, but “how to use test based development in Python, with wordle as an example” With that said, I agree that it gets a little tedious to read at times.