¿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 ):

• ¿Cuánto debería costar un sitio personalizado de WordPress para 10 páginas, informativo, con captura de plomo estándar y funciones de mapa?
• Cómo evitar que un usuario vea el mismo contenido de mi base de datos
• Cómo crear una miniatura con una descripción en la lista desplegable en HTML CSS
• ¿Cómo obtener todas las miniaturas de imágenes de un video como YouTube? ¿Se puede hacer esto usando JavaScript? Si no, ¿cómo hago esto?
• ¿Cuál es una forma económica de crear, imprimir y vender mis propios carteles?

  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.