いやー、英語で書かれてる云々よりも、解説の仕方というか、
書き方というか、その辺かと。
リファレンスとか読んでも、何が出来る、ってのは分かるんだけど、
あとは「書式」と「返り値」とか書かれてるだけで、
具体的にどういう感じに書けば良いのかがさっぱり掴めないんだよね。
リファレンスだけじゃなくて、「Cocoaはやっぱり！」も書き方同じだし。
「で？　どう書けばいいのよ？」みたいな。

分かってる人には分かるかもしれないけど、あれって、いわゆる
プログラマー的慣用表現なの？
初心者にはやっぱり分かりづらいと思うけどなぁ。