docs: update

Author: takaokouji

docs/adr/0001-stop-sprite-when-method.ja.md

@@ -9,26 +9,34 @@ Sorry, this is written in Japanese.
 
 # self.whenからself.を取り除いたRubyの命令を検討する
 
-` :flags: が押されたとき` などの各種イベントに対応したブロック(以下、イベントブロック)からRubyの命令へ変換すると `self.when(:flag_clicked) do ~ end` のように `Sprite#when` メソッドにマッピングされる。
+イベントカテゴリの `フラグが押されたとき` 、 `[スペース▼]キーが押されたとき` などの各種イベントに対応したブロック(以下、イベントブロック)は、`self.when(:flag_clicked) do ~ end` のように Ruby では `Sprite#when` メソッドにマッピングされる。
 
 ```ruby
+# フラグが押されたとき
 self.when(:flag_clicked) do
 end
 
+# [スペース▼]キーが押されたとき
 self.when(:key_pressed, "space") do
 end
 
+# [音量▼] > (10) のとき
 self.when(:greater_than, "loudness", 10) do
 end
 ```
 
-イベントブロックは多用されるため、これが不自然なものであれば、スモウルビーを通じてRubyの文法を学習するときに問題となる。
+`self.when` には次の課題がある。
+
+- Ruby では、publicなメソッドの呼び出しは通常は `self.` を省略するが、`when` は予約語であるため、常に `self.` を記述する必要がある
+- Ruby では、予約語をメソッド名に使うことはできるが、それを推奨するといった説明はどこにもない
+
+イベントブロックは多用されるため、これが不自然なものであれば、スモウルビーを通じてRubyの文法を学習するときに問題となることを懸念している。
 
 そこで、イベントブロックから Ruby の命令へのマッピングとして `self.when` ではない別の選択肢を検討する。
 
 ## 判断基準や制限
 
-* Rubyの文法を学べること
+* Rubyの文法を自然に学べること
 * Rubyの初学者に受け入れられるように入門書で扱うRubyの文法や仕組みを使うこと
   * 現状の「予約語 when を上書きする」というのは中級者以上を想定したものだと認識している
 * ブロックとRubyの相互変換処理の実装が簡単であること