views:

1346

answers:

26

I've noticed (is it just me?), that the really, really good programmers seem to be good at writing. Like their code flows, so does their written language.

To me, I suppose that makes sense: programming is writing programming languages. One writes code. Different code is written in different languages.

In your opinion, subjectively, does this hold, in general, true?

+11  A: 

The really good programmers that I know by reputation are good writers, and I'm sure that is because they developed their reputation by writing well. The best programmers that I have personally worked with have had no unusual talent for writing.

ScottS
+52  A: 

Not at all.

Think about it: you only read articles/blog posts from good programmers which are also good at writing. But you never read articles/blog post from good programmers which are not good at writing - because they don't even write articles.

Stefan
yeah: they are too busy poorly communicating ;-) I joke, I joke
Mitch Wheat
totally agree +1
Ric Tokyo
And possibly because their blogs don't get passed around because well they don't write well. Like my computer blog I closed it down, because my writing style does not work for computers, but I still write for the local paper, because my style fits the topic well.
Unkwntech
Yes... You always have to account for selection bias.
Dave Sherohman
But if more from group A (good writers) exist than those from group B (bad writers), there is still a correlation. Just because we don't read group B doesn't mean there aren't less of them. So no conclusion can be made.
FogleBird
+34  A: 

I'd say there's a correlation, but there are bound to be exceptions. Bear in mind that a good programmer doesn't just write good code - they write good comments, good documentation, good emails to their colleagues etc. Communication is hugely important in most programmers' jobs.

There's also the matter of "clear thinking leads to clear code" - if you can express what your code does accurately and concisely, you probably have a good handle on it, which means it's less likely to be buggy.

Note that this is about communication, not real "flair" when it comes to writing. You don't have to be a persuasive writer to write clean code, for example - but you should be able to explain yourself clearly.

Jon Skeet
Ah, reminds me of "voice." In non-technical writing, having a "voice" is important. "Voice" being a personality of sorts. In code (technical writing, if you will), no such thing exists. Style--sure, but style is usually related to readability, and is therefore (poor || > poor).
Chris
Anyway this is the good type of programmer that can explain what his code does, so the rest of the world understands it.
Johan
Downvoters: comments explaining the downvote are appreciated...
Jon Skeet
I think the correlation has to do with general level of intelligence, I have yet to meet a stupid/dumb but excellent programmer.
Unkwntech
I don't see any correlation. comments don't count IMO, they tend to be short and concise, and plus, you can document how to use a function even if you're not a good writer. you just say "pass a and b, function will do x and return z"
hasen j
@hasenj: I've seen a *huge* difference in comments between people who can express themselves clearly and those who can't. Those who are able to determine what information is important and what isn't vs those who say almost nothing or way more than necessary. That's part of the skill of writing.
Jon Skeet
"clear thinking leads to clear code" - I'd say that is spot on.
DanSingerman
+7  A: 

Some of the best code I've seen has been written by people who are also good communicators. Being a good communicator can take a lot of shapes, including:

  • interpersonal interactions
  • giving presentations
  • writing
  • playing the tuba

I think that if you include readability and expressiveness as adjectives that are applied to code from "good" coders, then I think that this makes sense. Communication is important in both writing code and life in general.

Defining the quality of code is related to this question, so I'll take a short stab at it as well. I value code that is both functional and expressive. If you had to pick one or the other I'd definitely pick functional code, but expressive code can be simpler, more elegant easier to understand, and more pleasant to maintain. As some other people have pointed out here, simple code is also more likely to be free of bugs, because there seems to be a correlation of bugginess with the number of moving parts in code.

Opposed to the idea of code as functional beauty, there's a lot of value in the model of writing lots and lots of functional code in a manner that's more pragmatic than elegant, and making things elegant when appropriate. A lot of amazing coders that I know follow that model. Some of them are awful communicators. :)

The bottom line is that there's some correlation, but I think that people who are on the skillful end of any distribution are likely to be better communicators.

James Thompson
+2  A: 

maybe is because good programmers may have a better understanding on the subjects and when they pass a lot of their time blogging,writing, reading and coding it becomes a more natural thing.

Oscar Cabrero
+3  A: 

What matters with broad generalizations such as "good programmers are good writers" isn't whether they are "true" but rather how you use them.

Should you hire someone who seems like a fine programmer and a good writer? Yes - they can contribute both skills in a team. Should you assume the best writer will be the greatest programmer one on the team? No. Should you test your teams' writing skills and fire the bad writers? No. Should you offer writing skills training to your team? Yes, if it seems useful.

Also, you may have heard about really good programmers who write well because they have communicated about themselves in blog and articles. The ones who don't write well might not have communicated about themselves as much. (Edit: those who put typos in the posts don't remembered as easily either)

Joe Soul-bringer
+2  A: 

Some say that good programmers are often good musicians, http://www.codinghorror.com/blog/archives/001214.html

tuinstoel
Good programmers are good at math. Math and language are processed on the same side of brain (left). Music, however, is on the right.
Tom
Math is one of the skills that are helpful. Communication skills and the ability to handle fuzzy project requirements are also helpful. I don't know for sure, but I'd guess that a good programmer is most likely using both sides of his brain.
Accipitridae
+3  A: 

I think you're making a pretty big mistake in your thinking. Just because two things are called "writing" doesn't mean they are actually the same, or use the same mental facilities. Just because two things are metaphorically related doesn't mean they are the same.

I think there are two reasons why you might think that good programmers are good writers

1) Smart people are probably going to be better writers then dumb people, and good programmers are obviously going to be pretty smart. But, but there are smart people who are not going to be good writers. They could have dyslexia, for example, or some other kind of aphasia. Those are extreme cases, but I think that if you adjust for intelligence good programmers are probably not better writers on average then other people.

2) People who are better at writing are better at explaining why their code is awesome. There could be great programmers out there who aren't very good at expressing themselves. No one will ever know how great they are because they can't explain it well, at least not without being very boring. On the other hand, someone who write well can explain their code in a way that's interesting. People will listen to them talking about their code, realize how awesome they are, and tell their friends. Those programmers who are great at writing or speaking will end up with reputations as great programmers.

Chad Okere
+2  A: 

Good communication is essential in performing any non-trivial task.

Unless you are writing code on your own (and I'm assuming that the majority of software written, isn't by just one person), then writing good software relies on good communication.

Look at some of the more useful parts of any software processes (agile, scrum, rup etc.) and they revolve around maximising good communication and disseminating information in an efficient way.

Even a continuous build process could be thought of as communicating problems to everyone sooner rather than later.

Mitch Wheat
+6  A: 

Test your hypothesis. Is the literary quality of SO better than your average public threaded discussion list?

le dorfier
Compared to other sites where good answers get up-voted and bad ones get buried, I would say SO isn't clearly any better.
Parappa
A: 

How many good communicators you know are not good programmers?

I personally know many bad programmers who are excellent communicators.

I don't think these are related in the least.

Being a good communicator is always a plus in any industry, as its always good to be able to articulate your thoughts..but one and the other (good communicator, programmer) do not relate.

Linus is very proud of not being a good communicator, I agree with him, but IMHO he is a very good programmer..

he is not an exception either, just a popular easy example to throw here.

Ric Tokyo
Are you distinguishing between written and verbal communication? You said "communicators" many times, but what are you referring to?
Chris
IMHO, a good writer is not just someone who avoids grammatical and syntactical errors, he or she will be articulate in expressing their intentions appropriately.When I say communicators I mean people who are good at expressing themselves. Written and verbal communication.
Ric Tokyo
Basically I mean to say is this:Agreeing with @Jon Skeet, its not so much about being a good writer, but a good communicator, and even then, the correlation might workout as "good to have, but not implied" in either direction goodwriter->goodprogrammer goodprogrammer->goodwriter.
Ric Tokyo
I think this is an interesting point
bobobobo
A: 

no, i notice my sentences are overly verbose as the c++ programming language that i write in. People also comment on my lack of Pronoun and i should try to be fluent in the english language (which is my native language). I tend to write with only nouns and everyone always comment on my bad grammar. (BTW ATM i am not trying to make my language worse, this is how i normally write. It isnt to bad? :))

acidzombie24
Writing with only nouns is pretty tough. However, see Steve Yegge's [Execution in the Kingdom of Nouns](http://steve-yegge.blogspot.com/2006/03/execution-in-kingdom-of-nouns.html) essay for an amusing look at this topic.
Greg Hewgill
+6  A: 

You might be interested to read the "Learn how to write..." section in Joel Spolsky's "advice to college students". Basically, there may not be a correlation between good coders and good writers, but there's certainly a correlation between influential coders and good writers.

timday
+1  A: 

Good coders are not good writers usually, but good engineers are.

Good writing is a skill, not a gift (we are not talking about writing fiction here). It is a skill that can and should be trained. I sure that everyone of us can find many examples from his own life when good writing and speaking really made difference.

Also you may found interesting answers to the question "Should programmers be able to write clearly?".

Dima Malenko
A: 

I think this works naturaly just like SO does, when a badly written blog post comes along, none "up-votes" (sends it to a friend), instead they "down-vote" (ignore it, and avoid the blog), so the good stuff tends to bubble to the top, and the bad stuff never get out of the gate.

Unkwntech
A: 

I don't think there is a correlation. Most of the programmers I have worked with are not good writers. What they write is not very creative and is straight to the point. They are also not good at UI design (even though most wouldn't admit it). I always assumed this was because programmers tend to be very logical and methodical (and less creative).

Just my thoughts..

BankZ
A: 

No direct relation. They are two completely different tasks with completely different requirements.

Writing good code requires that you be clear, concise, and correct.

Writing good prose requires that you be at least minimally entertaining (so your readers don't get bored and leave). It also often requires some degree of persuasiveness. Neither of these is entirely compatible with just stating the facts clearly and briefly, then being done with it.

The effect you've observed is simply selection bias. The good programmers you read are also good writers because, if they weren't good writers, you wouldn't be reading them.

Dave Sherohman
"Written language" doesn't mean "written prose" necessarily. There's a difference being able to communicate effectively in documentation and being able to write a novel.
Jon Skeet
A: 

longer I write code, more I write like yoda

David
"Hmm. Code more do I, like Yoda then I write."
Matthew Schinckel
@Matthew Damn, you been coding a lot longer then me huh?
David
+2  A: 

I just want to say that good written/spoken communication skills make good programmers great.

SkillSet skillSet = new SkillSet();
skillSet.Add(Skill.Coding, SkillLevel.High);

Programmer goodProgrammer = new Programmer(skillSet);

skillSet.Add(Skill.WrittenCommunication, SkillLevel.High);
skillSet.Add(Skill.SpokenCommunication, SkillLevel.High);

Programmer greatProgrammer = new Programmer(skillSet);
Brian Kim
+1  A: 

I would argue that good writing is a skill that affects a programmer's job performance. After all, what good is your code if nobody can figure out how to use it? Being a good writer will make you a better programmer, but it won't make you a good programmer.

Jason Baker
+2  A: 

If anything, I would say clear thinkers are clear programmers, and clear thinkers are clear writers

Jas Panesar
A: 

public static void myOpinionIs() { int repeat =0; while(numberOfTimes< 1000) if(programmer == goodCommunicator) iLikeToSay("He is a great programmer"); else iLikeToSay("He is a good Programmer"); repeat ++ }

+1  A: 

Edward Dijkstra says

Besides a mathematical inclination, an exceptionally good mastery of one's native tongue is the most vital asset of a competent programmer.
bobobobo
Alas, he wasn't quite right. As it turns out, it seems to be more important to speak the native tongue of one's peers.
TokenMacGuy
I think he meant communication. If you can take an idea from your brain and put it into ((any language's)) words, then you can take an idea and put it into ((the "words" of a computer programming language)).
bobobobo
A: 

I don't think so.

To be a good programming writer requires a number of steps. First, this person must be good at programming. This of course means that they can put code on the screen, and then show that it is right, and it is efficient. Not everyone can do all of these things.

Following that, it must be that the programmer can communicate effectively in code. This is essentially the art of writing code for others to read. I think that this is a skill that must be learned over time, with much feedback from others, and also requires that the programmer do a lot of reading code himself, which not every coder likes to do.

Next the programmer must have something to say, in code form. At some level, I think all passionate programmers have this feature. This is basically the pet project everyone is working on in their spare time. I'm not sure, but in my opinion, this is The Art Knuth was talking about.

Finally, The programmer must be able to communicate effectively in prose. This about as hard to learn as communicating in code, except that you can't ever really fall back on the excuse that prose is really for machines to understand, because prose, unlike code, doesn't have that audience. With code, you might be able to verify that it works, even if it ultimately fails at showing other programmers why you would want to do it that way. There is no unit testing for prose.

TokenMacGuy