improved doc on repos