Anduin2017/HowToCook

料理のレシピ集です。中身はコードではなく文章で、README には閲覧用の Web サービスを Docker で立てる手順も添えられています。

出発点は、作者が家で料理を始めたときの不満です。ネットのレシピは書き方がばらばらで、材料の欄になかったものが手順の途中から突然出てくる。分量は「適量」で終わる。形式言語に慣れた人間には、これが非常に読みにくい。だったら自分で、もっと明確で正確な書き方に統一して整理し直そうというのが趣旨です。掲げているのは「プログラマのための料理指南」です。

書き方が全編で揃っているのが肝です。材料を分量つきで先に全部並べ、手順は番号を振って、時間は「1分」のように数字で書く。火加減は「大火」「中火」「小火」と語で書かれていることが多い。書き方のひな形は「適量」「少量」「適当」といった曖昧な語を禁じ、待つ工程には所要時間か、終わったと判断する基準を必ず書くと定めている。読み手が途中で判断を求められる箇所を減らす、という方向で統一されています。そしてこれが個人のメモで終わらず、コミュニティ運営のリポジトリとして作られています。レシピの追加や修正は、プルリクエストで入ってきます。料理の手順をレビューして取り込む、という光景がそこにあります。

「適量」「お好みで」で止まるレシピに困っているとき

料理に慣れていないうちは、その一言がいちばん困ります。数字で書かれているものを探しているなら、そもそもそこを直すために始まったリポジトリなので、目的が一致します。

手順を書く形式のお手本がほしいとき

料理に限らず、社内の作業手順書や運用マニュアルでも「読み手に判断させない書き方」は同じ課題です。同じ形式で大量にそろっている実例として見ると、料理とは別の読み方ができます。

全編中国語です。 日本語に訳されたものは見当たりません。翻訳を通せば読めますが、調味料や調理法の言葉は訳がぶれやすいところなので、そのまま鵜呑みにはできません。

中国の家庭料理が中心です。 材料や調味料に、日本のスーパーではそのまま手に入らないものが出てきます。火力の前提も家庭用の中華コンロ寄りです。書き方の考え方は真似できますが、レシピをそのまま実行できるとは限りません。

スターの多さは実用性の証明ではありません。 動かして確かめてから星を付ける類のものではないので、「それだけの人が使って動作を確認した」という意味にはなりません。着眼点の面白さに票が集まっている面が大きいと考えたほうがいいです。

ライセンスは Unlicense で、著作権を主張しない、ほぼパブリックドメインに置く形が選ばれています。無保証である点も明記されています。火加減や食品の扱いを含む内容なので、そこは頭に入れて読んだほうがいいです。