¿Qué estilo usas para tus posts de compromiso? ¿Técnico o basado en características?

Digamos que estás trabajando en algún tipo de aplicación web. Aquí están las 2 versiones diferentes de posts de confirmación para el mismo set de cambios.

  1. Redirigir usuario a perfil_usuario para controlleres públicos -o– Restringir acceso de usuario registrado a controlleres públicos
  2. Agregue require_guest antes del filter a los controlleres necesarios

El primero explica cuál es el resultado de este cambio y el segundo básicamente explica cómo lo logró o qué cambió.

Entonces, ¿cuál prefieres? ¿y por qué?

DRY se aplica a los posts de confirmación, por lo que no repita nada que pueda ver en el código / diff.

Cree un context en su lugar: mencione el número del boleto que causó el cambio, explique por qué lo hizo y visualice una vista de 10'000 pies del cambio.

Ejemplo: "Asegúrese de que solo los usuarios verificados puedan acceder a páginas privadas" en lugar de "Llamadas agregadas a AccessController". Puedo ver el último desde el diff, pero el diff no explica por qué hiciste el cambio.

Prefiero tener un post de confirmación que mencione los dos extremos de la connection:

New require_guest before filter networkingirects users to user_profile for public controllers 

probablemente deberías mencionar ambos, y también un número de ticket, en caso de que uses algo como Trac o RedMine