Anduin2017/HowToCook

HowToCook is a community-driven cookbook that presents recipes in a format designed for programmers.

The project addresses the frustration of finding cooking recipes online that lack clarity and precision, with ingredients appearing unexpectedly mid-recipe and inconsistent formatting. It solves this by collecting common dish recipes written in a structured, unambiguous style that mirrors the formal language programmers are accustomed to. Recipes follow a consistent template and are presented both as markdown files in the repository and through a web interface for browsing. The project includes foundational cooking knowledge organized into tips and techniques, covering topics like kitchen preparation, food safety, and specific cooking methods such as steaming, stir-frying, and blanching.

The tool suits anyone seeking clearly written recipes, particularly those who appreciate structured, precise instructions over narrative-style cooking guides. It works well for home cooks who want to contribute recipes to a shared collection and benefit from community-maintained documentation. The project explicitly welcomes contributions through pull requests and provides a template system to maintain consistency across new recipes. Local deployment is supported through Docker for those who prefer to run the recipe service independently.

The project maintains active engagement with its user base, with nearly all open issues originating from outside contributors rather than the core team, demonstrating substantial real-world adoption. Maintainers typically respond to new issues and pull requests within a day. Work in the issue tracker centers on spam management, open discussion, and enhancement requests.