some routing cleanup/docs, refs #998