refactoring + doc strings for wire.routes