Skip to content

Proposal 0017: yield metadata for unit-based scaling#146

Open
dubadub wants to merge 2 commits intomainfrom
proposal/0017-produces-metadata
Open

Proposal 0017: yield metadata for unit-based scaling#146
dubadub wants to merge 2 commits intomainfrom
proposal/0017-produces-metadata

Conversation

@dubadub
Copy link
Copy Markdown
Member

@dubadub dubadub commented Apr 10, 2026

Summary

  • Repurposes yield exclusively for measurable recipe output (e.g., yield: 500%ml) and removes it as a synonym for servings
  • Resolves the ambiguity where yield meant both "serves N people" and the unit-based scaling output
  • Keeps servings/serves for people count; supports single and multiple yield values so a recipe can be referenced by different units

Rendered proposal

Test plan

  • Review proposal text for clarity and completeness
  • Verify examples are correct and consistent with existing Cooklang syntax
  • Confirm migration guidance (yield: 4servings: 4) is acceptable

dubadub added 2 commits April 10, 2026 18:57
Introduces `produces`/`output`/`makes` as a new canonical metadata key
to declare what a recipe produces in measurable units, resolving the
conflict where `yield` serves as both a servings synonym and the key
for unit-based scaling.
@tmlmt
Copy link
Copy Markdown

tmlmt commented Apr 11, 2026

The most natural use of servings, serves and yield to me (note: I am not an English native) are: “Serves 4,” “Yields 6 portions,” or “Makes 8 servings.". Given that, I kind of liked the simplicity of having to remember essentially two keys:

  • servings / serves (same root): for number of people
  • yield for the quantity produced (which corresponds to its dictionary definition)

Instead of having 6 different keys with half of them having ambiguous meaning.

@dubadub
Copy link
Copy Markdown
Member Author

dubadub commented Apr 12, 2026

Agree, basically the way I had it in a doc then. I'll update the proposal

@dubadub dubadub changed the title Proposal 0017: produces metadata for unit-based scaling Proposal 0017: yield metadata for unit-based scaling Apr 12, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants