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.


@emsenn @codesections I find that literate programming is a wonderful way of actually accomplishing the task. It's sort of taking the rubber-ducky problem solving method and applying it to the act of building in the first place.

People put a lot of hate on LP because they hate writing documentation/comments. I think we should have this whole topic nipped in the bud (so-to-speak) in school when it's being taught.

@ndegruchy I remember I heard some dev tell me rubber ducking as a phrase and I got so confused because I was like "you mean... planning? You plan things? And this is... special and worthy of note, in your field?"

Suddenly, a lot of how computers work was clear. @codesections

@emsenn @codesections Well, rubber ducking, as explained to me, is when you come across a problem you can't figure out, you talk to an inanimate object about the problem until you've figured out how to resolve it.

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.