Um pequeno documento sobre o significado dos comentários nos meus códigos: http://blog.gbaptista.com/2013/01/29/comentarios-metodos-variaveis-classe-instancia/

comments.rb

=begin

  [public]    = Público.
  [protected] = Protegido.
  [private]   = Privado.

  [class]     = De classe.
  [instance]  = De instância.

  [inherit]   = Herdado.

  Exemplos:

  - 'Métodos [instance public] são acessíveis...'
  = 'Métodos públicos de instância são acessíveis...'

  - 'Métodos [class private] não podem fazer isto.'
  = 'Métodos privados de classe não podem fazer isto.'

  - 'Métodos [inherit class private] são pimpões.'
  = 'Métodos privados de classe herdados são pimpões.'

  - 'Variáveis [inherit] são lindas.'
  = 'Variáveis herdadas são lindas.'

=end