adding route docs plus tweaks all around