some routing cleanup/docs, refs #915