update documentation using link_to and route helpers