What's wrong with a README? It's as close to a website as one can get within a self-contained repository, and is most likely to be kept up to date with any give

What's wrong with a README? It's as close to a website as one can get within a self-contained repository, and is most likely to be kept up to date with any given version of the project. If there is one document available anywhere that describes a project, I would hope it is the README.