Documenting the router's map function.

This depends on emberjs/ember.js#5368 being merged first so that the links work
properly.

It also fixes #1276.
Merge pull request #1652 from wbyoung/document-map

Documenting the router's map function.