Change Log¶
Use this page to summarize meaningful cookbook changes and help re-orient the project after a break.
The changelog should answer:
- What changed?
- Why did it change?
- Where should I look next?
- What is the current working model?
Current Project State¶
The Kester Family Cookbook is now a GitHub-backed MkDocs cookbook published at:
https://cookbook.connellkesters.com/
Current architecture version: Architecture 1.3
Current working model:
Rotation planning
↓
Recipe testing
↓
Website publishing
↓
AnyList cooking
↓
Cooking and transformation feedback
↓
GitHub cookbook revision
GitHub remains the source of truth. The website is the published reference. AnyList is the kitchen cooking tool.
Current guidance structure:
- Family Preferences: how the family likes to eat.
- Editorial Standards: how cookbook content is written and organized.
- Project Playbook: how the project operates.
Current recipe discovery model:
- Main Dishes are grouped by protein.
- Category index pages should help browse recipes, not act as placeholders.
- Recipe metadata should support browsing and planning.
Architecture History¶
Architecture 1.0 — Cookbook Foundation¶
Established GitHub as the source of truth and MkDocs as the cookbook publishing system.
Key concepts:
- GitHub stores permanent cookbook content.
- MkDocs publishes the cookbook website.
- Recipes live as Markdown files.
- Editorial quality matters more than recipe quantity.
Where to look:
Architecture 1.1 — AnyList as Kitchen Runtime¶
Refined the workflow after recognizing that AnyList is not merely an export destination. It is the tool used while cooking.
Key concepts:
- Recipes may enter AnyList while still in testing.
- A recipe should be cooked successfully from the kitchen format before approval.
- AnyList sync tracking is manual, not automated.
- Version fields help spot when GitHub has changed since the AnyList copy was imported.
Where to look:
Architecture 1.2 — Dinner-to-Transformation Systems¶
Added support for recipes designed to become intentional second meals.
Key concepts:
- Leftovers are passive.
- Transformations are planned.
- Some recipes are meal systems: dinner plus an intentional next meal.
- A transformation recipe is not fully tested until both the dinner and the transformation have been evaluated.
Where to look:
Architecture 1.3 — Organization and Discovery¶
Improved how recipes and editorial guidance are found and maintained.
Key concepts:
- Main Dishes are grouped by protein.
- Recipe category pages should become discovery pages.
proteinmetadata supports browsing and weekly planning.- Permanent guidance is separated into Family Preferences, Editorial Standards, and Project Playbook.
- Import-facing recipe content stays near the top of recipes; editorial content stays below the cooking instructions.
Where to look:
2026-07-06¶
Implemented Architecture 1.3¶
Added organization and discovery improvements so the cookbook is easier to browse and maintain as it grows.
Changed:
- Added
proteinmetadata to the recipe standard. - Added
proteinmetadata to the recipe template. - Updated Grilled Flank Steak with Chimichurri with
protein: beef. - Rebuilt the Main Dishes index as a protein-based discovery page.
- Grouped Main Dishes by protein in the site navigation.
- Reorganized the Editorial sidebar into Family Preferences, Editorial Standards, and Project Playbook.
- Updated the Editorial landing page to explain where long-term decisions belong.
Why it matters:
The planning chat can now import the rest of the week's recipes using a clearer template and navigation structure. The cookbook is also easier to browse by how people actually plan meals.
Implemented Architecture 1.2¶
Added dinner-to-transformation support as a first-class cookbook concept.
Changed:
- Added transformation metadata fields.
- Added a Planned Transformation section to the recipe template.
- Added transformation feedback guidance.
- Added the Transformation Workflow editorial page.
- Updated recipe standards to distinguish leftovers from transformations.
- Added Transformation Workflow to site navigation.
Why it matters:
This supports the actual meal-planning pattern where dinner is intentionally designed to become a second meal, especially for work boxes and 2:00 AM meals.
Implemented Architecture 1.1¶
Updated the architecture to reflect that AnyList is the practical cooking tool.
Changed:
- Updated the recipe lifecycle to include publishing, AnyList import, cooking from AnyList, and feedback.
- Updated recipe standards so approval depends on practical cooking success.
- Added AnyList cooking notes to the recipe template.
- Added a Cooking Feedback section to the recipe template.
- Renamed the navigation entry to Publishing and AnyList Cooking.
Why it matters:
The cookbook should not merely publish recipes. It should support the way the family actually cooks.
Added AnyList Tracking Metadata¶
Added structured metadata for manual AnyList tracking.
Changed:
- Added recipe
version. - Added
website:metadata. - Added structured
anylist:metadata. - Added
imported_versionto make version mismatches easier to spot.
Why it matters:
This does not automate AnyList sync, but it makes it easier to know whether the AnyList copy reflects the current GitHub recipe.
Added Standardized Recipe Metadata¶
Expanded the recipe metadata into a standardized recipe card.
Changed:
- Added timing fields.
- Added effort, make-ahead, work-box, leftover, freezer, and kid-friendly fields.
- Added primary ingredients, equipment, and tags.
Why it matters:
This makes recipes easier to search, review, classify, and convert into practical cooking tools.
Built the Editorial Architecture¶
Added the major editorial pages that define how the cookbook should operate.
Changed:
- Added Recipe Lifecycle.
- Added Recipe Metadata Standard.
- Added Rotation-to-Recipe Workflow.
- Added Seasonal Index.
- Added Ingredient Index.
- Added Work Box Index.
- Strengthened Recipe Standards.
- Expanded the Editorial index page.
Why it matters:
The cookbook is now an editorial system, not just a folder of recipes.
Completed Publishing Setup¶
Completed the infrastructure setup for the published cookbook.
Changed:
- Set the canonical site URL to
https://cookbook.connellkesters.com/. - Connected the GitHub-backed cookbook to Cloudflare publishing.
- Verified that MkDocs builds successfully.
Why it matters:
The cookbook can now be published and used as the basis for AnyList imports.
2026-07-05¶
Created Initial GitHub/MkDocs Cookbook Structure¶
Created the starter structure for the Kester Family Cookbook.
Changed:
- Added MkDocs configuration.
- Added recipe folders.
- Added planning, editorial, and reference sections.
- Added initial recipe template.
- Added starter recipe standards.
- Added pantry and equipment reference pages.
Why it matters:
This established the permanent cookbook repository and basic site structure.
Changelog Rules¶
Add an entry when a change affects:
- Cookbook architecture.
- Recipe lifecycle.
- Metadata standards.
- Publishing workflow.
- AnyList workflow.
- Transformation workflow.
- Navigation or organization.
- A recipe becoming approved, archived, or materially revised.
Minor copy edits do not need changelog entries unless they affect cooking, publishing, or project direction.