¿Por qué Ruby on Rails tiene tantos comentarios?

Gracias por A2A.

Tantos comentarios es un término muy relativo. Ruby on Rails es un marco y, como sabemos, es utilizado por millones de personas en todo el mundo. Una fracción de esta gente también trabaja en eso, y necesitan entender lo que hace cada parte.

Además de eso, estos comentarios son muy útiles para los principiantes, ya que describen la convención utilizada en ciertas partes del marco, por ejemplo, el archivo de enrutamiento ( routes.rb ):

  Rails.application.routes.draw do
  raíz 'bienvenido # índice'
  # La prioridad se basa en el orden de creación: primera creación -> máxima prioridad.
  # Vea cómo todas sus rutas se presentan con "rutas de rastrillo".

  # Puede enrutar la raíz de su sitio con "root"
  # raíz 'bienvenido # índice'

  # Ejemplo de ruta regular:
  # get 'products /: id' => 'catalog # view'

  # Ejemplo de ruta con nombre que se puede invocar con buy_url (id: product.id)
  # get 'products /: id / adquirir' => 'catálogo # compra', como:: compra

  # Ruta de recursos de ejemplo (asigna verbos HTTP a acciones del controlador automáticamente):
  # recursos: productos
  # ...

Esto va de la mano con la convención de Rails sobre configuración (CoC).

La mayoría de los grandes proyectos de software tienen muchos comentarios. Algunos de estos comentarios tienen un propósito específico (generación de documentación, por ejemplo) o dan instrucciones para las personas que desean cambiar algo en la base del código actual.