Document the Router.map function.

This is one step toward fixing emberjs/website#1339.
Need to provide the @method YUIDoc flag also.