I agree however I didn't want to launch into the reasoning behind this. Maybe we can add a section at the top of the API docs about this?