Documenting the router's map function.

This is another step toward fixing emberjs/website#1339.

It depends on emberjs/ember.js#5368 being merged first so that the links work properly.

It also fixes #1276.