Literate Programming

To be clear, I don’t think I’ve written a line of code yet this year, at least, not that was for a legitimate project and not for

Still, I work with people who code and, when I was thinking about the Governors and Generals thing, I asked about how to plan a program. One of my colleagues–fresh out of college–talked about using UML to model stuff. Then, one of the more experienced programmers heard us talking about it and told me to Google Literate Programming.

Short aside on Google suggestions

There was a time when I thought people telling me to Google something were just saying “you’re not worth my time.”

Getting older, I realize they’re saying “you seem to be teaching yourself this stuff, but here’s a concept you may not know to learn about. Have a look.” And I appreciate that.

Now, as a rule, when I have the idea something is possible and I don’t know what to search for (I want to update a website dynamically in a certain way) I tend to ask “do you know what I need to Google to figure this out?” It respects the other person’s time and makes it clear that I’m not looking for them to do the work for me.

So what is it?

The idea is that, before you write a line of code, you write out your program in English. The guy who pointed me towards it said that, eventually, nothing should be a mystery: you just have to translate English into code.

That means that you write “here, the cards in the user’s hand are selected and passed through to the Django template to be displayed,” because that’s something I’m confident I can do in straightforward code without having to figure out how it’s done.

The way he sold it to me was that you construct the entire program in plain English before writing anything, so you know what you need to get done and then you just translate it into code.

I’m giving it a try with Governors and Generals

I like the idea. But then, I can be sold on “literate” anything. Because I’m tired of pandemic stagnation, I’ve decided to kick myself in the butt and get an MVP going.

Now, sitting down and pounding out what needs to get done… I’m realizing that there’s a sense to it and I’m excited to see where it takes me. I would like to get back to being a person who makes things.

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s