I find aliases to be pretty clearly bad API. By all means, include those aliases in documentation so people can search using them, but having a code base litter

I find aliases to be pretty clearly bad API. By all means, include those aliases in documentation so people can search using them, but having a code base littered with two different names for the same thing makes it harder to search, learn from and code-mod it.