The README will become an entry point for using the project. Notes on design decisions and explanations of the rules are split off into their own documents.