Update README and add READMEs in sub-directories

I think this might be a good idea to document the code in Travis Core on a higher level. I started adding some READMEs, but I'd love some feedback on the explanations, especially for the subdirectories in `lib/travis`.

I'm planning to add some more documentation to the rest of the code as well, and also update some of the outdated docs.