汚くならないでしょう。キャプションを分離しようとすると面倒なのは否めません。言語仕様」をどうにかしたい。出来ると良いかもしれないと思いました。バックエンドが使えるなら、書きかけのは別ブランチでやれば済むのかもしれませんね。引数なんて自動的に検出できるんだから自動で付ければよい。検出できるのでしょうか?ドキュメント本体です。二番目の形式では、ブロックが真を返した最初の要素の位置を返します。ブロック引数には、要素が順に渡されます。valと考えられます。してしまってもよいでしょう。リファレンスとかでやってますが、まず外れません。feature」のタグ付けが統一されておらず見苦しい。どのあたりが統一されていないと感じるのでしょうか?そのパターン分けが細かすぎて嫌だということです。feature」は本体末尾のみに記述するべきだと思います。いまと逆に古いバージョンの仕様のほうを互換性情報として述べるか。あと、個人的に開発版の仕様は書くべきでないと思ってます。書くとしても、デフォルトで見せるのは不適切。理想的には、ドキュメントのうち別バージョンの解説をしている部分を自動的に隠したり抜き出したりできるといいなあと思います。バージョンに対応するドキュメントを動的に生成できるし。どのファイルがリファレンスなのか自動判別しにくい。ありますが、完全ではなさそうな気がします。作者&メンテナとして断言しますが、ものすごく抜けてます。ヒューリスティックに判定するのはウンザリしました。フォーマットを統一してほしい。パースしやすいフォーマットを提案してほしいです。前提なら最低でも以下は満たしたいです。しているモジュールの記述を一定させること理想的には以下も追加。