💾 Archived View for station.martinrue.com › gordonguthrie › 911c4cc4233b40e89bc05b2519787dd8 captured on 2023-04-26 at 14:54:47. Gemini links have been rewritten to link to archived content
⬅️ Previous capture (2023-04-20)
-=-=-=-=-=-=-
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.
4 months 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. · 4 months 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. · 4 months ago
that is just source code · 4 months ago
hey @syntheist you get to be the first person to see it https://gordonguthrie.github.io/literatecodereader/ · 4 months ago
What do you mean by “readable format”, something like · 4 months ago