[swift-evolution] Issues with 0005-Better Translation of Objective-C APIs Into Swift

[swift at lng.la]

> On Feb 2, 2016, at 11:49, Aaron Crespo via swift-evolution <swift-evolution at swift.org> wrote:
> 
> I think Kevin and I come from the same place and largely agree. I feel like this is trading in of accessibility and discoverability for the sake of terseness. This might be aesthetically pleasing but gives up many positive side effects the more descriptive names provide.
> 
> Consider the time before you knew you could or how to "check the documentation". Or the time spent scanning unfamiliar or long forgotten code.

I think it's a failing of the learning process if you're working with an API in a way that autocomplete discoverability is valuable but you don't know how to check its documentation. If this is a real problem, we should find better ways to teach people how to find and use the documentation.

Jarod