Add code examples to @api functions.

Title says it all.
I'd be tempted to skip the return here (though your comment below clarifies, it risks misinterpretation since it is named `otherCoord`).
```js
var coord = [-180, 45];
ol.coordinate.add(coord, [360, -90]);
// coord is now [180, -45]
```