«
»

Do as we say, not as we do

From the Coding Guidelines for Cocoa:

Avoid ambiguity in API names, such as method names that could be interpreted in more than one way.

sendPort

Does it send the port or return it?

displayName

Does it display a name or return the receiver’s title in the user interface?

From the Cocoa API:

-[NSConnection sendPort]

-[NSPortMessage sendPort]

-[NSDocument displayName]

-[NSFont displayName]

This entry was posted on Thursday, August 30th, 2007 at 6:42 pm and is filed under Apple, Cocoa. You can follow any responses to this entry through the RSS 2.0 feed. Both comments and pings are currently closed.

One Response to “Do as we say, not as we do”

  1. Peter Hosey says:
    August 30, 2007 at 8:02 pm

    To say nothing of all their HIG violations.