add documentation on how to set your repository up to work well with our auto-detect routines