Patrones de confirmación

Aprenda a escribir confirmaciones semánticas y profesionales.

Patrones de confirmación

Según la documentación de confirmaciones convencionales, las confirmaciones semánticas son una convención simple que se utiliza en los mensajes de confirmación. Esta convención define un conjunto de reglas para crear un historial de confirmaciones explícito, lo que facilita la creación de herramientas automatizadas. Estas confirmaciones le ayudarán a usted y a su equipo a comprender más fácilmente qué cambios se realizaron en el código confirmado. Esta identificación se produce a través de una palabra y un emoji que identifica si el commit comprometido es un cambio de código, actualización de paquete, documentación, cambio visual, prueba…

Tipos de compromisos

Las confirmaciones semánticas tienen los siguientes elementos estructurales (tipos), que informan la intención de su confirmación al usuario de su código.

✨

feat

Indica que su fragmento de código incluye una nueva funcionalidad (relacionada con MINOR en el control de versiones semántico).

git commit -m ":sparkles: feat: adicionar autenticação de usuário"

🐛

fix

Indica que su fragmento de código confirmado está resolviendo un problema (corrección de errores), está relacionado con PATCH en el control de versiones semántico.

git commit -m ":bug: fix: corrigir loop infinito na validação"

📚

docs

Indica que ha habido cambios en la documentación, como en el README de su repositorio (no incluye cambios de código).

git commit -m ":books: docs: atualizar README com instruções"

💄

style

Indica que hubo cambios relacionados con el formato del código, punto y coma, espacios en blanco, pelusa (no incluye cambios de código).

git commit -m ":lipstick: style: corrigir formatação do código"

♻️

refactor

Se refiere a cambios debidos a refactorización que no alteran la funcionalidad, como mejoras de rendimiento debido a la revisión del código.

git commit -m ":recycle: refactor: otimizar algoritmo de busca"

⚡

perf

Sirve para identificar cualquier cambio de código relacionado con el rendimiento.

git commit -m ":zap: perf: melhorar tempo de carregamento"

🧪

test

Se utiliza cuando se realizan cambios en las pruebas, ya sea creando, modificando o eliminando pruebas unitarias (no incluye cambios de código).

git commit -m ":test_tube: test: adicionar testes unitários"

🔨

build

Se utiliza cuando se realizan modificaciones para crear archivos y dependencias.

git commit -m ":package: build: atualizar dependências"

🧱

ci

Indica cambios relacionados con la integración continua.

git commit -m ":bricks: ci: configurar pipeline de deploy"

🔧

chore

Indica actualizaciones para crear tareas, configuraciones de administración y paquetes (no incluye cambios de código).

git commit -m ":wrench: chore: atualizar .gitignore"

🗃️

raw

Indica cambios relacionados con archivos de configuración o datos sin procesar.

git commit -m ":card_file_box: raw: dados brutos do projeto"

🧹

cleanup

Indica limpieza de código, eliminación de comentarios innecesarios y optimizaciones generales.

git commit -m ":broom: cleanup: remover código não utilizado"

🗑️

remove

Indica la eliminación de archivos, funciones o códigos que ya no son necesarios.

git commit -m ":wastebasket: remove: deletar arquivos obsoletos"

Patrones de emojis

Tipo de confirmación	emojis	Palabra clave
Accesibilidad	♿	:wheelchair:
Agregar una prueba	✅	:white_check_mark:
Actualizando la versión del submódulo	⬆️	:arrow_up:
Degradar la versión del submódulo	⬇️	:arrow_down:
Agregar una dependencia	➕	:heavy_plus_sign:
Cambios en la revisión del código	👌	:ok_hand:
Animaciones y transiciones.	💫	:dizzy:
Corrección de errores	🐛	:bug:
Comentarios	💡	:bulb:
compromiso inicial	🎉	:tada:
Ajustes	🔧	:wrench:
Desplegar	🚀	:rocket:
Documentación	📚	:books:
En curso	🚧	:construction:
Estilo de interfaz de usuario	💄	:lipstick:
Infraestructura	🧱	:bricks:
lista de tareas	🔜	:soon:
Mover/Cambiar nombre	🚚	:truck:
Nueva funcionalidad	✨	:sparkles:
Paquete.json en JS	📦	:package:
Actuación	⚡	:zap:
Refactorización	♻️	:recycle:
Limpieza de código	🧹	:broom:
Eliminar un archivo	🗑️	:wastebasket:
Eliminar una dependencia	➖	:heavy_minus_sign:
Sensibilidad	📱	:iphone:
Revertir cambios	💥	:boom:
Seguridad	🔒	:lock:
SEO	🔍	:mag:
Etiqueta de versión	🔖	:bookmark:
Pasar la prueba	✔️	:heavy_check_mark:
Pruebas	🧪	:test_tube:
Texto	📝	:pencil:
Mecanografía	🏷️	:label:
Manejo de errores	🥅	:goal_net:
Datos	🗃️	:card_file_box:

Comandos principales de Git

Repositorio de clones

Clona un repositorio remoto de GitHub existente en su entorno local.

git clone url-do-repositorio-no-github

Inicializar repositorio

Inicializa un nuevo repositorio Git en el directorio actual.

git init

Agregar archivos

Agrega todos los archivos y cambios en el directorio actual al área de preparación.

git add .

Hacer compromiso

Registra los cambios agregados al área de preparación con un mensaje descriptivo.

git commit -m "mensagem do commit"

Cambiar nombre de sucursal

Cambia el nombre de la rama actual (maestra) a principal. -M se usa para forzar el cambio de nombre.

git branch -M main

Agregar repositorio remoto

Agrega un repositorio remoto llamado origen al repositorio local.

git remote add origin https://github.com/usuario/nome-do-repositorio.git

Enviar al repositorio

Envía confirmaciones desde la sucursal local al repositorio remoto.

git push -u origin main

Actualización desde el repositorio

Actualiza la sucursal local con cambios del repositorio remoto.

git pull origin main

Conectar el repositorio local

Cuando ya tienes un repositorio local y quieres conectarlo a un repositorio remoto en GitHub.

git remote add origin git@github.com:usuario/projeto.git
git branch -M main
git push -u origin main

Obtener actualizaciones

Obtiene todas las actualizaciones del repositorio remoto sin fusionarlas en la rama actual.

git fetch

Empuje forzado seguro

Una forma más segura de forzar que los cambios locales se envíen al repositorio remoto.

git push --force-with-lease

Revertir confirmación

Crea una nueva confirmación que deshace los cambios realizados por la confirmación especificada.

git revert id_do_commit_que_vai_ser_revertido

Restablecer confirmación

Restablece el repositorio al estado de confirmación especificado y elimina todos los cambios posteriores.

git reset --hard id_do_commit_anterior_ao_que_vai_ser_apagado

Cambiar mensaje de confirmación

Cambia el mensaje de la última confirmación.

git commit --amend -m "mensagem_reescrita"

Selección de cereza

Se utiliza para obtener una confirmación específica de otra rama.

git cherry-pick HASH_DO_COMMIT

Sucursal de intercambio

Cambie a una rama diferente en el repositorio local.

git switch <branch>

Glosario

fork

Copie un repositorio a su propia cuenta de GitHub.

issues

Herramienta utilizada para gestionar tareas y corregir errores.

pull request

Mecanismo utilizado para enviar propuestas de cambios al repositorio original.

gist

Herramienta para compartir fragmentos de código.

💡Consejos importantes

✓Utilice mensajes claros y descriptivos que expliquen lo que se ha cambiado.
✓Mantenga los compromisos pequeños y centrados en una sola característica
✓Utilice el tipo de confirmación correcto para facilitar la navegación por el historial
✓Pruebe siempre sus cambios antes de confirmarlos

Patrones de confirmación