💾 Archived View for station.martinrue.com › gordonguthrie › 911c4cc4233b40e89bc05b2519787dd8 captured on 2023-01-29 at 05:55:07. Gemini links have been rewritten to link to archived content

View Raw

More Information

➡️ Next capture (2023-03-20)

-=-=-=-=-=-=-

👽 gordonguthrie

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.

1 month ago · 👍 digbat

Actions

👋 Join Station

5 Replies

👽 gordonguthrie

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. · 1 month ago

👽 syntheist

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. · 1 month ago

👽 gordonguthrie

that is just source code · 1 month ago

👽 gordonguthrie

hey @syntheist you get to be the first person to see it https://gordonguthrie.github.io/literatecodereader/ · 1 month ago

👽 syntheist

What do you mean by “readable format”, something like · 1 month ago