To API designers/spec developers: pity those of us who have to LEARN this...