WOW, I'm on hackernews, wow! I completely agree on not shortening array, object, private, public, etc. I reached a similar decision a while ago, but didn't get around to fixing the docs.
I like shortening fn though, as it often makes the difference if an expression containing an anonymous function can fit on one 80 character line or not.
About the "!_->" syntax in the validation part of the function definition. Recently I've decided to remove the entire validation part, because the syntax is too specific and weird. I still like the defining of arguments on top of the function because it removes duplicate argument names between docblocks and code. The idea of validation together with the argument defintion is still sound i think though.
Perhaps function should be allowed in both long and short form. I might be willing to use fn for an anonymous function but much less likely in regular situations.
I like shortening fn though, as it often makes the difference if an expression containing an anonymous function can fit on one 80 character line or not.
About the "!_->" syntax in the validation part of the function definition. Recently I've decided to remove the entire validation part, because the syntax is too specific and weird. I still like the defining of arguments on top of the function because it removes duplicate argument names between docblocks and code. The idea of validation together with the argument defintion is still sound i think though.