Update `map()` documentation
Update `map()` documentation

Update the `map()` documentatation to include the relevant annotations
to be included by the documentation builder and add a short description.

ReactiveX/RxPHP