And then README describes how you're doing your spec (says what files to look at for what details etc) - polyfills/patches can maybe go here, too. And you should use CONTRIBUTING.md to describe how you're using GitHub (because that gets linked on Issues/Pull Request pages).