Ответ 1
Хэш-формат (метод класса #) недействителен рубином, но используется в документации для описания метода экземпляра.
Методы класса обычно документируются с использованием метода double-colon (Class:: method).
Вы увидите примеры как в рубиновых документах (например, http://www.ruby-doc.org/core-1.9.3/String.html)
Точечный формат используется в коде при фактическом вызове метода класса (Class.method), хотя я видел, что некоторые люди (к сожалению) используют его взаимозаменяемо с двухточечной или хэш-информацией в документации.