Saltar al contenido

Un criterio de historial para 4 repositorios

Apliqué un único criterio de historial a cuatro repositorios — commits convencionales, sin emojis ni líneas de atribución y con un hook de mensajes de commit —, junto con 48 documentos de instrucciones que regulan la forma de trabajar.

48 documentos de instrucciones que regulan la forma de trabajar

Situación. Cuatro repositorios construidos durante dieciocho meses por una persona es la situación en la que más fácil resulta saltarse el proceso, porque no hay nadie con quien coordinarse y el coste de un historial ilegible recae por completo en una versión futura de esa misma persona que aún no se ha quejado. También es la situación en la que más probable resulta un historial incoherente, ya que cada repositorio puede derivar hacia sus propios hábitos sin nada que los una.

Tarea. Un estándar para el historial y otro para las instrucciones debían aplicarse en todos los repositorios en los que se redacta el trabajo, y su cumplimiento debía ser mecánico en lugar de depender de la memoria.

Acción. El estándar de commit es un prefijo convencional que nombra el tipo de cambio y un ámbito, un asunto por debajo de una longitud fija, sin emojis y sin líneas finales de atribución de ningún tipo; esto último porque una atribución que da crédito a una herramienta no es un hecho sobre el cambio, y el historial sirve para los hechos sobre cambios. Un hook de mensaje de commit rechaza todo lo que no cumple, en cada repositorio que contiene trabajo, de modo que el estándar es una propiedad del repositorio y no de quien crea el commit. La distribución en el mayor repositorio muestra en qué consistió realmente el trabajo: 156 commits de funcionalidades, 133 correcciones, 128 de documentación, 81 de mantenimiento, 26 refactorizaciones, 20 de estilo, 5 de rendimiento y 3 de pruebas. La documentación está lo bastante cerca de las correcciones como para llamar la atención, y eso es consecuencia de la segunda mitad de este trabajo: 48 documentos de instrucciones entre los cuatro, cada uno dedicado a un dominio y escrito como reglas y no como descripción, todos accesibles desde un único documento de entrada por repositorio para que haya un solo punto de partida. Un analizador de documentación impone presupuestos de tamaño por archivo y presencia en el índice, de modo que el conjunto sigue siendo navegable en lugar de crecer hasta convertirse en un archivo histórico.

Resultado. Cuatro repositorios comparten un formato de historial y una estructura de instrucciones, ambos impuestos por hooks y no por disciplina. Lo que esto no hace es convertir el historial en uno bueno: se comprueba el formato y no el contenido, de modo que un asunto conforme que no describe nada pasa exactamente igual que uno que explica el cambio.

  • Libros antiguos en una estantería
    Foto: 4262159 / Pixabay
  • Auditoría, contabilidad, libro mayor
    Foto: Tumisu / Pixabay

Aplique esta experiencia a su proyecto

Utilice «Un criterio de historial para 4 repositorios» como punto de partida para un reto similar en su organización. Los servicios que respaldan este trabajo están disponibles para su proyecto. Alguien de su lado de la mesa cuando una decisión sobre proveedores, presupuesto o arquitectura necesita una segunda opinión informada.

Explore nuestros servicios Póngase en contacto

Mire más allá del resultado

Lea la situación, las decisiones y el resultado de este ejemplo. Podemos hablar de qué partes se adaptan a sus restricciones y cuáles necesitan otro enfoque. Un criterio de historial para 4 repositorios — 48 documentos de instrucciones que regulan la forma de trabajar

Explore nuestros servicios Póngase en contacto

Una parte de una trayectoria más amplia — y toda ella está en este sitio.

Cada entrada sigue la misma estructura: la situación, la tarea, lo que hicimos y lo que cambió.

Vea la trayectoria completa

Defina la mejora que necesita

Describa la decisión, las personas afectadas y las opciones ya consideradas. Podemos hacer explícitos los compromisos entre objetivos y dejar una recomendación documentada.

Vea cuánto cuesta Póngase en contacto

¿Quiere un mismo criterio en todos sus repositorios?

Pregunte por las decisiones detrás de «Un criterio de historial para 4 repositorios». Hablará con las personas que pueden explicar el trabajo y valorar su propio proyecto.

Explore nuestros servicios
welcome@engineer.company +45 50 10 61 84 Copenhague, Dinamarca
Código QR de Apliqué un único criterio de historial a cuatro repositorios — commits convencionales, sin emojis ni líneas de atribución y con un hook de mensajes de commit —, junto con 48 documentos de instrucciones que regulan la forma de trabajar.
Llévese esta páginahttps://advisory.engineer.company/es/portfolio/held-4-repositories-to-one-history-standard/