Sto progettando una piccola libreria e c'è una strong tentazione di fornire sinonimi ad alcune delle funzioni esportate.
var foldl = function(){ ... };
var reduce = foldl; //reduce is a synonym for foldl
Immagino che i nomi multipli possano aiutare l'apprendimento iniziale dell'API (poiché è più probabile che l'utente inciampi nella funzione che desidera) ma allo stesso tempo mi preoccupo che la duplicazione porterà complessità inutile.
Quali regole dovrei tenere a mente quando penso di aggiungere un sinonimo a una funzione nella mia API?
Quando dovrei scegliere un "c'è più di un modo per farlo" api e quando dovrei incentivare c'è un modo per farlo "invece?