Registro de cambios del proyecto

La versión actual de la página aún no ha sido revisada por colaboradores experimentados y puede diferir significativamente de la versión revisada el 25 de junio de 2018; las comprobaciones requieren 2 ediciones .

El registro de cambios del proyecto ( registro de cambios en inglés  ) es un registro de software de los cambios realizados en un proyecto grande. Este proyecto puede ser un sitio web o un proyecto de software. Por lo general, las entradas del registro de cambios contienen información sobre correcciones de errores, nuevas funciones, etc. La mayoría de los proyectos de código abierto contienen el registro de cambios como uno de los archivos de nivel superior.

El nombre canónico para los archivos de cambios es ChangeLog , [1] pero a veces se denomina CAMBIOS o HISTORIA ( NOTICIAS generalmente se denomina archivos de cambios de versión, no registro de cambios). Algunos mantenedores de proyectos agregan el sufijo .txt al nombre del archivo .

Algunos sistemas de control de versiones son capaces de generar información apropiada que es adecuada para registrar cambios.

Formato

Los archivos de cambios se organizan según elementos que definen cambios únicos en una función o archivo. La mayoría de los archivos de cambios tienen el siguiente formato: [2]

AAAA-MM-DD John Doe <[email protected]> * myfile.ext(myfunction): mis cambios realizados cambios adicionales * myfile.ext (unrelated_change): mis cambios realizados a myfile.ext pero completamente sin relación con lo anterior * anotherfile.ext (alguna función): más cambios

Tenga en cuenta que hay espacios entre la fecha y el nombre y luego entre el nombre y la dirección de correo electrónico. También es una regla encerrar una dirección de correo electrónico entre comillas < y >. Estas entradas adicionales del registro de cambios son añadidas por el editor de Emacs .

Registro de cambios en Wikipedia

La mayoría del software de proyectos Wiki incluye un registro de cambios como característica fundamental (a menudo denominado historial en este contexto ). Por ejemplo, el enlace "Historial" en la parte superior de la ventana de Wikipedia lo lleva a la página de registro de cambios del artículo. Esta característica es vital para cumplir con los requisitos de atribución de algunas licencias de derechos de autor.

Véase también

Notas

  1. El manual de automake de GNU . Fecha de acceso: 27 de diciembre de 2011. Archivado desde el original el 27 de diciembre de 2011.
  2. Estándares de codificación GNU: estilo de los registros de cambios . Fecha de acceso: 27 de diciembre de 2011. Archivado desde el original el 26 de diciembre de 2011.

Enlaces