Here's an interesting perspective: Code Is Not Literature

It addresses a puzzle:

> [So many programmers say], “People should read code” but few people seem to actually do it. I’d be surprised if I interviewed a novelist and asked them what the last novel they had read was, and they said, “Oh, I haven’t really read a novel since I was in grad school.” Writers actually read other writers but it doesn’t seem that programmers really do, even though we say we should.

@codesections i just woke up but for everything OP says is why literate programming is bad is alost why i say it's good, lol.

@codesections nvm i see now that they realize they were, mis-applying the notion.

(Since I started advocating for literate programmin, I've seen a lot of people argue that "code isn't a narrative," or whatever else, and to me those all seem to miss the point - literate programming isn't writing the code to be red, it's writing the /software/ to be read. The code is just the equivalent of charts and tables that demonstrate implementation.

@codesections I frequently read other people's code for work, but also for pleasure/learning. It's sort of a hobby of mine to seek out Helm charts / large bash scripts and dissect them. The awful/arcane/powerful things do with Bash leaves me with a weird mix of respect and nausea =D

@codesections If this part appeals to you: "One reasonable approach might be to show the real code and then to show a stripped down reimplementation of just the key bits, kind of like a biologist staining a specimen to make various features easier to discern.", then you might find _500 Lines or Less_ to be worth a look:

Also, the other books in the series are worthy as well.

Sign in to participate in the conversation

Fosstodon is an English speaking Mastodon instance that is open to anyone who is interested in technology; particularly free & open source software.