March 21st, 2008

How to write like Raymond: What I tell you three times is true

Another installment in the extremely sporadic series on how to write like Raymond. On occasion, I’ll find myself engaged in a mail thread with a customer who refuses to believe what they’re being told and is under the impression that rephrasing the question will get a different answer. “My customer wants to control the name and appearance of the XYZ icon in the DEF dialog.” — There is no public interface for manipulating that icon. “Can I change the icon’s appearance?” — There is no public interface for manipulating that icon. At this point, I say to myself, “Two.” And there’s a nonzero chance that I will be rewarded with a third question: “What about in C++?”

What I tell you three times is true. There is no public interface for manipulating that icon.

Author

Raymond has been involved in the evolution of Windows for more than 30 years. In 2003, he began a Web site known as The Old New Thing which has grown in popularity far beyond his wildest imagination, a development which still gives him the heebie-jeebies. The Web site spawned a book, coincidentally also titled The Old New Thing (Addison Wesley 2007). He occasionally appears on the Windows Dev Docs Twitter account to tell stories which convey no useful information.

0 comments

Discussion are closed.