Improving docs and paving road for further progress

There really is a lot that I want to do on repoctl, and I outlined
them a little in the GitHub issues tracker.