Find Work Find Talent
a digital silouette

Photo by Aram Bartholl

What Writing Taught Me About Coding (and Vice Versa)

Written By R.E. Warner | Nov 23, 2016

I’ve been writing fiction since roughly the eighth grade—it depends on if you count creating D&D adventures as fiction writing (I do). I’ve also been monkeying around with code in the form of Basic and Logo since the sixth grade.

Now I’m 41, and only in the last few years have I begun to see the many parallels between the two arts. They are both fundamentally writing. Coding certainly has a much more structured syntax and adherence to logic, but that now appears to me as a superficial difference. The object remains ultimately the same: to create a work that changes minds.

The object remains ultimately the same: to create a work that changes minds.

Both fiction and coding have the creative capacity to represent anything in the known universe, including things that haven’t happened yet, or may never happen. Creativity often shows its best colors when you’re working within limitations; like the boundaries of a problem you’re trying to solve. But the fact that you can write fiction about anything at all and that you can write code to do anything at all means that the first lesson is setting your own boundaries. Don’t write a novel first and don’t think the first piece of code you write is going to be an iPhone app. Those goals are so ambitious that somewhere along the way, nine times out of ten, the charged energy of the creative spark will get dampened by piling problems, and you won’t finish.

Even experienced writers and programmers need to start with something small. In programming it’s referred to as KISS (Keep It Simple, Stupid)—a bit condescending yes, but a really important rule of thumb. Create something that does one thing and does it really well. Write first about a character, not the whole story—tackle who the person is. The code analog is to write a simple object, maybe even just a standalone function. And even then, doing this once is not enough. You need to polish that rock. Try thinking of awkward situations to put your character in, or examples of input that break your code. Ask what could go wrong and then re-draft.

That’s a start, but how do you build from there? In both writing and coding, I’m allergic to planning. I just want to write the code; just want to get to the end of the story. As an exercise, that’s a fine thing to do in a moment of creative inspiration, but the pragmatist in you should recognize that in order to make your craft good, you’ll probably have to cut the spontaneous stuff. Exploration is a valuable tool, no doubt, but many of the writers I know are too precious with their first tries. They want to edit—not re-write.

Editing is when you cut this line of dialogue or change that phrasing, and word processors have made writers lazy, because what is truly required is to write it again. Trust that all the important and salient details that made you want to write the story in the first place will return, but the density of the narrative will improve. When I decided to apply this to my coding efforts, I was delighted to find that the same effect occurred. Re-writing code from memory (small algorithms or functions—not whole applications, mind) generally caused me to find greater insight into what I was doing, and create code that was a few lines shorter.

Succinctness and efficiency is a goal in both disciplines. As Blaise Pascal wrote, “I’m sorry I wrote you such a long letter; I didn’t have time to write a short one.” And Pascal should know, he was a writer and a mathematician—a somewhat early form of the modern coder.

Still, even when I speak of the difference between drafting and re-writing, I’m talking about re-writing small, functional parts. I would never re-draft a book or re-write an entire program from memory. So to get to the novel or the application, a plan is ultimately required.

I’m agnostic about planning tools. From Gantt charts to outlines, I’ve got no favorites, and what works for one project might not be what I use for the next. I’m no project management expert, but the most important element of this plan (for writing or coding) is understanding dependencies. What are the core elements upon which the program, or the story, rest? What has to happen first? How odd would it be for two characters to clairvoyantly discuss an event that happens later in the story without an explanation? In code, the result would be more obvious: you would have a bug. In a way, there are many similarities between bugs and plot holes–both result in missed interaction between the craftsman and the audience. Readers are distracted from the story, users are distracted from their end goal.

Succinctness and efficiency is a goal in both disciplines.

Let me belabor that point. One of the greatest similarities between writing and coding is that at the other end of the process, an unfamiliar brain sits waiting to make sense of it all. Users, readers–same thing. You might think up a program that needs no audience, but until there is artificial intelligence, every program needs input and creates output, and somewhere along the way a human brain has to make sense of the output. And you can write a story that no one ever reads; in fact, you can just think of it and never write it down, but then, does it exist at all and how do call that a story? Fiction and code is meant to be shared; they’re created with language and that’s why language evolved, so we could share ideas.

So whether you are setting off to write the next great American novel or the latest iPhone app, good luck! I think you can do it, just remember to start small. Start somewhere really plausible, and then see if you can start even smaller. Polish that little idea, not the big one hovering around in the back of your mind, but the one that marks your beginning. Then try to do it differently, and don’t be afraid to discard your beginning and start again. When you think your idea looks/works pretty well, or when you have a few of them that work well together, take a step back and survey that big idea again. It may have changed slightly, given your education with the smaller ideas. It’s okay to re-draft plans too.

And always remember that this stuff is best when shared, so make it with that “unfamiliar brain” in mind. Let people close to you try it out; listen to their feedback, don’t be too precious with what you’ve done. Code and stories have this in common too: the re-making and re-telling of them is often an evolutionary process toward a better version.

R.E. Warner is a writer of story, poetry and code. He enjoys putting symbols in orders that make sense to both humans and computers. You can see his code at russellbits.com and check out his fiction at theneverendingfictionmachine.com.

This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.