I don't like putting it on the README either. I think such a document is likely to become outdated and useless regardless of where we put it.