I <3 Steve McConnell*
Coding Horror
programming and human factors
by Jeff Atwood

April 17, 2006

Are You Following the Instructions on the Paint Can?

We're currently undertaking some painting projects at home. Which means I'll be following the instructions on the paint can.

Paint can

But what would happen if I didn't follow the instructions on the paint can? Here's a list of common interior painting mistakes:

The single most common mistake in any project is failure to read and follow manufacturer's instructions for tools and materials being used. In regard to painting, the most common mistakes are:
  • Not preparing a clean, sanded, and primed (if needed) surface.
  • Failure to mix the paints properly.
  • Applying too much paint to the applicator.
  • Using water-logged applicators.
  • Not solving dampness problems in the walls or ceilings.
  • Not roughing up enamel paint before painting over it.

What I find particularly interesting is that none of the mistakes on this checklist have anything to do with my skill as a painter. My technical proficiency (or lack thereof) as a painter doesn't even register! To guarantee a reasonable level of quality, you don't have to spend weeks practicing your painting skills. You don't even have to be a good painter. All you have to do is follow the instructions on the paint can!

Sure, it seems like common sense. But take a close look at the houses on the streets you drive by. Each street has that one house where the owners, for whatever reason, chose not to follow the instructions on the paint can.*

For years, software development was an entire subdivision of badly painted houses. But the field of software development is now mature enough that we have a number of paint cans to refer to. Here's one such checklist from Joel Spolsky, circa 2000:

  1. Do you use source control?
  2. Can you make a build in one step?
  3. Do you make daily builds?
  4. Do you have a bug database?
  5. Do you fix bugs before writing new code?
  6. Do you have an up-to-date schedule?
  7. Do you have a spec?
  8. Do programmers have quiet working conditions?
  9. Do you use the best tools money can buy?
  10. Do you have testers?
  11. Do new candidates write code during their interview?
  12. Do you do hallway usability testing?

The type of paint can you choose-- and the instructions you follow-- are highly debatable, of course. But make sure, at the very least, you're following the instructions on the paint can for your software development project.

* oddball color choices notwithstanding

Posted by Jeff Atwood    View blog reactions
« Your Personal Brand
Remote Desktop Tips and Tricks »
Comments

First!

Kurt Koller on April 17, 2006 4:35 PM

Are you really painting your house lilac?
#E1B4D5???

Jon Galloway on April 17, 2006 5:15 PM

I hope you made a copy of the instructions before slopping paint all over the original.

Carl Manaster on April 17, 2006 6:00 PM

No, we're actually painting it in the Hot Dog Stand color scheme.

http://www.codinghorror.com/blog/archives/000341.html

Jeff Atwood on April 18, 2006 12:11 AM

I wish I could make every engineer at my company follow that checklist...

On another note, I've been in Tech Support a few times and 95% of the problems are easily fixed by reading the manual.

Ian Muir on April 19, 2006 6:03 AM

Interesting, James Bach is "Studying Jeff Atwood's Paint Can"

I like this bit "I want to talk, here, about the danger of following instructions, and more specifically, the danger of following people who tell you to follow instructions when they are not taking responsibility for the quality of your work. The instruction-following myth is one of those cancers on our craft, like certification and best practices."

http://blackbox.cs.fit.edu/blog/james/archives/000211.html

Pete McBreen on April 25, 2006 2:26 PM

Yes, James emailed me about that. Like all of his stuff, it's great and well worth reading. It's funny because he actually dug up something I hadn't consciously realized: I used to run a painting business, so a lot of the paint instructions are easily understandable to me.

It will take me a little while to formulate a response, but here's the Reader's Digest version: I think we disagree on the meaning of "following the instructions".

Jeff Atwood on April 25, 2006 2:52 PM

lkkkkkkkkkkkkkkkkhgfchuotfyuigli

ugne on January 31, 2008 4:43 AM

I working as painter basically to paint your place you need to have right time's work slow, prime good, sand good, use the right paint,
read instruction on can's

ted on May 13, 2008 4:37 PM

school

clare on June 6, 2008 7:34 AM

What about good ol' shlemiel? Fundamentals are important, such as knowing when to ask questions not asked on the paint can. Just look first, eh?

God,

Grant me the serenity to accept the things I cannot change,
the courage to change the things I can,
and the wisdom to know where to bury the bodies.

Amen.

Jared on February 13, 2009 2:25 PM
Content (c) 2009 Jeff Atwood. Logo image used with permission of the author. (c) 1993 Steven C. McConnell. All Rights Reserved.