documentation and route convenience callback