I think the Overall Structure and What files are generated sections should be put into a "docs/architecture.md" file or similar.