Sign In

Communications of the ACM

Kode Vicious

Literate Coding

flowers with code

While it is true that "programmers aren't English majors," there are many days that I wish they were, or that they knew one and offered to help with their science or math homework in return for some help making themselves better understood.

The full text of this article is premium content


Andrew Fry

At the risk of violent agreement - source code has two main purposes. One purpose is execution leading to some actions. The other purpose is communicating (to humans) what the system does and perhaps how it is done (the system usually encompassing much more than computers).

For any program that is used over a significant period, communications is more important than the execution actions - the actions (which are probably wrong) will be updated and changed over time - but the communications aspect is necessary to update the program.

Please continue beating the heads of recalcitrant "programmers".

R Oldehoeft

Another vote for KV on literate coding. I had a long academic CS career, and can offer a few anecdotes:

* When I met with high-schoolers bused in to campus, I would tell them that they should study all the math, science, and ENGLISH that their school offers--not a popular message.

* I would tell my own undergraduate students that the most important programming language was English! If they are good technically, they will be required to communicate with other humans on a literate level--another unpopular message.

* I required a term paper in my programming class (after surveying them about languages they knew) about a language that they did not know, giving a wide list to choose from and providing a template about what they should report. One graduating senior, in turning his in at class, sighed: "That's the last writing I will ever have to do!" I just smiled, knowing that, from the second bullet above, he was probably right.

Displaying all 2 comments

Log in to Read the Full Article

Sign In

Sign in using your ACM Web Account username and password to access premium content if you are an ACM member, Communications subscriber or Digital Library subscriber.

Need Access?

Please select one of the options below for access to premium content and features.

Create a Web Account

If you are already an ACM member, Communications subscriber, or Digital Library subscriber, please set up a web account to access premium content on this site.

Join the ACM

Become a member to take full advantage of ACM's outstanding computing information resources, networking opportunities, and other benefits.

Subscribe to Communications of the ACM Magazine

Get full access to 50+ years of CACM content and receive the print version of the magazine monthly.

Purchase the Article

Non-members can purchase this article or a copy of the magazine in which it appears.
Sign In for Full Access
» Forgot Password? » Create an ACM Web Account