Un registro de cambios es un registro o registro de todos los cambios notables realizados en un proyecto. El proyecto es a menudo un sitio web o un proyecto de software, y el registro de cambios generalmente incluye registros de cambios como correcciones de errores, nuevas funciones, etc. Algunos proyectos de código abierto incluyen un registro de cambios como uno de los archivos de nivel superior en su distribución.
Históricamente, un registro de cambios ha incluido todos los cambios realizados en un proyecto. En cambio, el sitio "Keep a Changelog" aboga por que un registro de cambios no incluya todos los cambios, sino que debería contener "una lista curada y ordenada cronológicamente de cambios notables para cada versión de un proyecto" y no debería ser un "volcado" de un git log "porque esto no ayuda a nadie". [1]
Aunque la convención de nomenclatura canónica para el archivo es ChangeLog , [2] a veces se denomina alternativamente como CAMBIOS o HISTORIA ( NOTICIAS suele ser un archivo diferente que refleja los cambios entre las versiones, no entre las confirmaciones). Otra convención es llamarlo CAMBIO . [1] Algunos mantenedores de proyectos agregarán un sufijo .txt al nombre del archivo si el registro de cambios es texto sin formato , un sufijo .md si está en Markdown , o un sufijo .rst si está en reStructuredText .
Algunos sistemas de control de revisiones pueden generar la información relevante que se adapta como un registro de cambios si el objetivo es incluir todos los cambios.
Un registro de cambios de golang es sinónimo de un conjunto de cambios de código y la revisión del código asociado .
Formato
Los archivos de registro de cambios están organizados por párrafos, que definen un cambio único dentro de una función o archivo. Los estándares de codificación GNU recomiendan el siguiente formato: [3]
AAAA-MM-DD John Doe@example.com> * myfile.ext (myfunction): mis cambios realizados cambios adicionales * myfile.ext (unrelated_change): mis cambios realizados to myfile.ext pero completamente ajeno a lo anterior * anotherfile.ext (alguna función): más cambios
Tenga en cuenta que entre la fecha y el nombre, y nuevamente entre el nombre y la dirección de correo electrónico, hay dos espacios cada uno. Es común incluir la dirección de correo electrónico entre
Registros de cambios en wikis
La mayoría del software wiki incluye registros de cambios como característica fundamental (a menudo denominada historial en este contexto). Por ejemplo, el enlace "Ver historial" en la parte superior [4] de una entrada de Wikipedia enlaza con el registro de cambios de esa página. Esta función es vital para cumplir con los requisitos de atribución de algunas licencias de derechos de autor. [ cita requerida ]
Registros de cambios de productos
Un registro de cambios de producto permite mantener a los clientes informados sobre las novedades. Ayuda a anunciar nuevas funciones, últimos lanzamientos y noticias relevantes directamente en la aplicación.
Ver también
Notas
- ^ a b "Mantenga un registro de cambios" . keepachangelog.com . Consultado el 3 de septiembre de 2019 .
- ^ El manual de GNU automake .
- ^ "Estándares de codificación GNU: estilo de registros de cambio" . Gnu.org . Consultado el 3 de septiembre de 2019 .
- ^ Ayuda: Page_history .