Ask HN: API Method Naming Clarity

2 pointstablet1 comment

We are designing API and arguing with developers to death about clarity.

Let's say you have a service that allow to add entities to collections. For example, you can add Task to Feature. What name is better?

1. addToCollection(type, id, collectionField, collectionEntityId)

2. addCollectionItem(type, field, id, itemId)