こんばんは、sheepmanです。

メソッドの引数の書き方は統一しておく必要があると思います。
具体的には以下の点です。

 * 省略可能な引数の表し方。
 * 引数のデフォルト値を書く場所。

省略可能な引数は以下のように「[]」を使って表すのが慣例です。

--- slice(nth[, len])

以下の2点を決める必要があると思います。

 * これを必ず書くようにするか。
 * メソッドの引数の説明文でも改めて省略可能であることを説明するか。

また、引数のデフォルト値に関しても同じように、決めておく必要があると思います。
以下のようにするのが慣例ですが、

--- sum([bits=16])

 * この慣例を必ず書くか。
 * メソッドの引数の説明文でも改めてデフォルト値がなんであるかを書くか。

-- 
sheepman / TAMURA Takashi
sheepman@s... 

--
ML: ruby-reference-manual@m...
使い方: http://QuickML.com/