document discovery mechanism and limitations
save users and repos along the way