CONTRIBUTING Guide

如何贡献

直接修改/添加做菜指南并提交 Pull request 即可。

在写新菜谱时，请复制并修改已有的模板: 示例菜。

记得在提交 Pull Request 前同样更新一下 Readme.md 里的引用。

内容规范

菜谱提交者无需阅读此内容规范。以下内容已经以简明易懂的方式包含在示例模板中。项目的维护者会在你的PR中提出建议, 并协助修改。

本项目的 Motivation 要求菜谱满足以下规范，不符合规范的菜谱将不会被合并到代码库中。项目的维护者维护此文档, 作为正式的标准与共识。

每一道菜谱至少应包含原材料与工具, 计算, 操作三部分内容。

原材料与工具应列出本菜品需要的除假想已准备好的物品外的所有原材料与厨具。
计算应定量列出本菜品所需的原材料的量。（无论与人数是否相关）
操作应说明菜品的制作步骤。

菜品的制作步骤应当明确(无歧义,non-ambiguous)，并尽可能准确(accurate)。有歧义(ambiguous)的描述是不可接受的，而不准确(inaccurate)或不精确(imprecise)的描述是可以接受的。

不准确的菜谱会导致菜品口味有少许偏差，不明确的菜谱会导致做菜人的心态有明显不安。

举例：有歧义的描述

# 解释：此处对于盐量的描述是有歧义的。
#       因为对于某个数量的盐，用户无法得出确定的客观结论：此数量是否属于"少量"。
加入少量盐

加入几滴耗油
将锅加热至八分热
撒上少许葱花
煮至鸡肉断生

举例：无歧义的描述

# 解释：此处对于锅的温度的描述是不准确的（可能是200摄氏度左右的任何温度），但这个描述是无歧义的。
#       因为对于锅的某个状态，用户可以进行水滴测试，并得出确定的客观结论：此状态要么符合要求，要么不符合要求。
加热锅，直至"滴入几滴水时，水珠能够在锅上迅速滚动而不吸附"
加热锅，直至观察到莱顿弗罗斯特现象

加入5ml酱油
等到水沸腾后
继续煮，直到汤汁剩下二分之一
煎至表面呈金黄色
继续翻炒两分钟

# 食材所可能粘附的蛋液的量是确定的
裹上蛋液

# 在'计算'中已提及将用到葱花的量
撒上葱花

考虑到现实因素，对于某些在家庭厨房中确实难以明确描述的因素，可以作为特例排除。例如

# 在描述燃气灶火焰强度时
文火, 小火, 中火, 大火 等
# 在描述颜色时
金黄色 等
# 在描述硬度时
变软 变硬

菜品的制作步骤应当完整(complete)。这意味着, 在执行完所有操作步骤后, 菜品已经被完成。
菜品的原材料与工具应当完整(complete)。这意味着, 在执行操作步骤时, 没有用到原材料与工具中未提到的物品。

2.9 KiB Raw Blame History Unescape Escape

CONTRIBUTING Guide

如何贡献

内容规范

2.9 KiB

Raw Blame History