Break down recipe instructions further

[luizribeiro]

I think it would be nice to be able to break down recipe's instructions further. This sometimes make long recipes easier to follow. For example:

# Dough

Mix @flour, @yeast, ...

Knead by hand or beat the dough with your #mixer

....

Roll dough into a 12-inch circle. Cover and rest as you prep the pizza toppings.

# Toppings

Spread @marinara sauce{} over base, followed by @cheese.

...

# Baking

Bake it at very high temperature for ~{15%minutes}.

I'm borrowing the syntax for sections from markdown headings, but I do realize there is a bit of a conflict with how we mark cookware right now.

An interesting thought might be to, instead of writing sections, representing the steps for producing a product instead.

For example:

$dough: {
  Mix @flour, @yeast, ...

  Knead by hand or beat the dough with your #mixer

  ...
}

$toppings: {
  ...
}

Roll $dough into a 12-inch circle. Cover and rest.

Spread @marinara sauce{} over base, followed by @cheese and the prepared $toppings.

Bake it at very high temperature for ~{15%minutes}.

The interesting thing of representing it this way is that it would unlock us to ability to reuse and do combinations of different recipes (e.g. different recipes for pizza toppings, while using the same dough recipe). It also helps with readability a lot IMO since it separates clearly the different parts of the recipe by their products (which could even be used later on in other parts of the recipe).

[dubadub]

Hi @luizribeiro I'm wondering if including dough and topping recipes from separate files will solve the same issue?

[DanMacKay1961]

I think this is a necessary feature too. I suggest using a meta called >>section:

[Net-Mist]

I agree. This is a natural solution I think. See for instance https://raw.githubusercontent.com/Net-Mist/remy/98464bb9868657fd4c6ed12f3d3081a19a91aca5/recipes/plats/Flammekueche.cook

[PlayerCreed]

这是来自QQ邮箱的假期自动回复邮件。   您好，我最近正在休假中，无法亲自回复您的邮件。我将在假期结束后，尽快给您回复。

[dubadub]

Relevant proposal for spec change #104.