From 2aabe8a5cd0fbd35f76b5eef1ae58aa67460123f Mon Sep 17 00:00:00 2001 From: MarcusPierce Date: Tue, 5 Apr 2022 22:03:08 -0700 Subject: [PATCH] Update CONTRIBUTING.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 按照中英文混排规范以及考虑上下文一致性做出部分修订 --- CONTRIBUTING.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 118f2175..5ef7d7c4 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -20,7 +20,7 @@ `计算`应定量列出本菜品所需的原材料的量。（无论与人数是否相关） `操作`应说明菜品的制作步骤。 -- 菜品的制作步骤应当明确（无歧义,non-ambiguous），并尽可能准确(accurate)。有歧义(ambiguous)的描述是不可接受的，而不准确(inaccurate)或不精确(imprecise)的描述是可以接受的。 +- 菜品的制作步骤应当明确无歧义(non-ambiguous)，并尽可能准确(accurate)。有歧义(ambiguous)的描述是不可接受的，而不准确(inaccurate)或不精确(imprecise)的描述是可以接受的。 > 不准确的菜谱会导致菜品口味有少许偏差，不明确的菜谱会导致做菜人的心态有明显不安。 @@ -28,7 +28,7 @@ ``` # 解释：此处对于盐量的描述是有歧义的。 -# 因为对于某个数量的盐，用户无法得出确定的客观结论：此数量是否属于"少量"。 +# 因为对于某个数量的盐，用户无法得出确定的客观结论：此数量是否属于"少量"。 加入少量盐 加入几滴蚝油 @@ -41,11 +41,11 @@ ``` # 解释：此处对于锅的温度的描述是不准确的（可能是200摄氏度左右的任何温度），但这个描述是无歧义的。 -# 因为对于锅的某个状态，用户可以进行水滴测试，并得出确定的客观结论：此状态要么符合要求，要么不符合要求。 +# 因为对于锅的某个状态，用户可以进行水滴测试，并得出确定的客观结论：此状态要么符合要求，要么不符合要求。 加热锅，直至"滴入几滴水时，水珠能够在锅上迅速滚动而不吸附" 加热锅，直至观察到莱顿弗罗斯特现象 -加入5ml酱油 +加入 5 ml 酱油 等到水沸腾后 继续煮，直到汤汁剩下二分之一 煎至表面呈金黄色 @@ -62,7 +62,7 @@ ``` # 在描述燃气灶火焰强度时 -文火, 小火, 中火, 大火 等 +文火，小火，中火，大火 等 # 在描述颜色时 金黄色 等 # 在描述硬度时 @@ -81,11 +81,11 @@ - 绝对不允许菜谱中出现灵活发挥的空间。不允许让厨师自己斟酌加入的量。不允许出现 `适量` `少量` - 绝对不允许出现允许厨师自己决策的步骤。例如：`可以根据自己的喜好调整煮的时间`这类语句 -- 针对单个大小体积重量差距极大的物体，不允许用个来约束，要额外标注重量 g +- 针对单个大小体积重量差距极大的物体，不允许用个来约束，要额外标注重量(g) - 勺 不是一个可靠的单位。建议换成毫升 ml - 确保文件路径合理，文件引用正确，没有签入无意义的文件 - 对蒜的描述，指的是三头还是三瓣可能产生歧义 -- 允许出现 `大火` `中火` `小火` +- 允许出现 `小火` `中火` `大火` - 任何标点符号，例如顿号，都需要额外确认是否是`可以替代的或`，还是`必须同时添加的和` - 如果一个原材料仅仅计算了一次，而引用了多次，必须额外确认每次引用时指的量的多少 - 确保他在合并前更新了 Readme 对他的菜谱的引用，如果他是在新加菜谱的话