Notas de versión desde Git

Pega mensajes de commit o un diff unificado para preparar las notas. La sugerencia de versión se basa en las marcas de los commits y requiere revisión.

Se ejecuta localmente en tu navegador
Esta herramienta procesa todos los datos localmente en tu navegador.
Commits o Git diffPega Conventional Commits, asuntos de git log o texto de diff unificado.
Borrador Markdown de versión
Ejecuta la herramienta para mostrar aquí el resultado procesado localmente.

Cómo redactar notas de versión desde commits o un diff

Pega asuntos de Conventional Commits — puedes copiarlos directamente de git log --oneline — o un diff unificado, y la página los convierte en un borrador Markdown con los cambios agrupados y un nivel major, minor o patch sugerido.

Aquí no se toca ningún repositorio: el texto pegado se analiza dentro del navegador, el botón de ejemplo rellena una muestra y Copiar o Descargar sacan el borrador como release-notes.md.

  1. Pega el texto en Commits o Git diff: un asunto Conventional Commit por línea, una lista de git log --oneline o la salida de un diff unificado con encabezados diff --git.
  2. Pulsa Generar notas de versión. Las líneas que no son asuntos de commit ni contenido de diff — autores, fechas, marcadores de hunk — se omiten.
  3. Revisa el borrador: los commits se agrupan en Funciones, Correcciones, Rendimiento, Cambios, Documentación, Pruebas y Build y CI, y todo commit marcado con ! o seguido de un pie BREAKING CHANGE queda señalado.
  4. Comprueba el nivel sugerido: major si hay un cambio incompatible marcado, minor si hay algún feat y patch en el resto de casos. El borrador lo llama sugerencia porque el número final lo decides tú.
  5. Copiar o Descargar recogen el resultado; Limpiar vacía los dos paneles.

Qué lee esta página y qué deja en tus manos

Qué se reconoce

Los asuntos de commit admiten un prefijo hash corto o largo opcional, así que abc1234 feat: … y un hash completo de 40 caracteres se leen como commits. El scope se conserva: feat(api): add filters cae en Funciones con el scope entre paréntesis.

La lista de tipos es el conjunto de Conventional Commits — feat, fix, docs, style, refactor, perf, test, build, ci, chore — más revert. El diff necesita encabezados diff --git reales: la lista de archivos y los recuentos de líneas + / − solo salen de las líneas posteriores a un encabezado, de modo que un + suelto en el texto no se cuenta como adición.

El nivel de versión es una sugerencia

major = al menos un marcador ! o un pie BREAKING CHANGE; minor = al menos un feat; patch = todo lo demás, incluidos docs, pruebas, style y chore. Son reglas mecánicas, así que lee el borrador antes de etiquetar una versión.

La línea de sugerencia es texto plano dentro del borrador y no se publica en ningún sitio: esta página solo produce la salida.

Lo que esta página no hace

No lee ningún repositorio Git, no ejecuta git ni llama a ningún servicio de red: solo se analiza el texto que pegas.

Los formatos que quedan fuera se avisan en lugar de adivinarse: una caja vacía responde con el aviso de pegado y un texto sin asuntos de commit ni contenido de diff recibe su propio mensaje. Los resúmenes de git diff --stat y los diff binarios no se convierten en estadísticas de líneas.

Herramientas recientes: