The yak shaving continues. All documentation systems focus on libraries and how to use your software and none on how to understand your software. And we don't apply basic typographic principles to reading code. So of course I have to write a thing that takes source code and compiles it to a more readable format, and off to the races I go. Yak, yak, shave the yak.
2 years ago · 👍 digbat
yeah @synghesist, added SuperCollider today as I am writing some stuff in that. I did some teaching of total newbies in lockdown and if I go back to it I want to be able to write rly readable code and examples. I really believe is starting people polyglot and try and get them to build complete systems, so Gemini, writing a smol database server where all the data is written in human readable files. Need a way of producing themed content across all of them. · 2 years ago
That kind of reminds me of literate haskell, but supposed to be for any language? Also reminds me of org-mode. Not to put you down or anything, there's just so many ways to shave that particular yak, all different. · 2 years ago
that is just source code · 2 years ago
hey @syntheist you get to be the first person to see it https://gordonguthrie.github.io/literatecodereader/ · 2 years ago
https://gordonguthrie.github.io/literatecodereader/
What do you mean by “readable format”, something like · 2 years ago