[afarrell]

The problem is that the "obvious thing" relies on implicit knowledge of whoever is designing the API and might be nonobvious to someone else.