civicrm_contribution_add: 'contribution_type' param overrides 'contribution_type_id'

It is an undocumented feature that civicrm_contribution_add will accept 'contribution_type' as a key containing the string name of a contribution type.

This wouldn't be a problem, except when both 'contribution_type' and 'contribution_type_id' keys exist, the string designation overrides the ID designation. This seems a bad idea to me, but in any case, this should be documented if it is intentional or otherwise necessary.