tune up plugin handling and some docs about routes indexes