The one thing that stuck with me the first time (when we studied this in grad school) was that designing interfaces (to functions, APIs, etc) is hard - and that

The one thing that stuck with me the first time (when we studied this in grad school) was that designing interfaces (to functions, APIs, etc) is hard - and that you'll never get it right the first time.