A curated collection of exemplary README files and resources to inspire and improve project documentation.
Awesome README is a curated collection of exemplary README files from open-source projects, serving as a reference and inspiration for developers writing project documentation. It solves the problem of poorly documented projects by providing concrete examples of effective READMEs that include elements like clear descriptions, screenshots, badges, and installation guides.
Open-source maintainers, developers starting new projects, technical writers, and anyone looking to improve their GitHub project presentation and documentation quality.
Developers choose Awesome README because it offers a practical, example-driven approach to documentation improvement, saving time and providing proven patterns instead of abstract guidelines.
A curated list of awesome READMEs
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
Features over 50 categorized README examples from popular projects like dbt-core and gofiber/fiber, each highlighting specific effective elements such as badges, GIFs, and clear structure.
Includes a dedicated section with ARCHITECTURE.md examples from projects like esbuild and Tauri, providing concrete guidance on documenting project design and organization.
Lists utilities like readme-md-generator and GitHub Readme Stats, helping automate badge creation and README generation with ready-to-use options.
Curates articles and presentations from experts like Tom Preston-Werner, offering best practices and philosophy beyond just examples.
The selection is based on curator preferences without objective criteria, which may not align with all documentation styles or modern trends.
As a collection, it doesn't provide interactive tools or templates; users must manually adapt examples, which can be time-consuming for quick setups.
Examples primarily focus on general open-source software, with fewer resources for specialized domains like embedded systems or enterprise APIs.