docs($ionicPlatform): note that it returns a promise

Addresses #991