Separate README.md (project overview) from docs/index.md (detailed usage
overview). Use GitHub friendly URLs.