fixes typo in routes
adds some comments to clarify how to refactor things