Someone needs to start doing comp-lit style studies of computer code instead of literature.

Most of the problems of API design could be remedied by people stepping through their own code and looking askance at the whole process.