Cómo escribir excelentes commits

Marco Elizalde — Tue, 17 May 2022 23:22:31 +0000

Te ha pasado que cuando entras a un repositorio y buscas la lista de commits los comentarios son poco entendibles, no tienen una estructura definida o colocan mensajes como «se arregló error», pero estos comentarios no te aportan nada para entender el porqué del commit.

Elaboré este pequeño tutorial para mostrarte un formato que puedes aplicar en los comentarios de tus commits, que te ayuden en la navegación y da una idea de primer vistazo de los cambios realizados dentro de los mismos.

La estructura del mensaje es la siguiente:

<type>(<scope>): <subject>

Ejemplo:

feat(assets): se integran los assets para redes sociales. fix(Signin): se corrige inicio de sesión con facebook Type

En el tipo de commit tenemos las siguientes opciones para elegir:

feat: Una nueva funcionalidad.
fix: Cuando se va a subir alguna corrección.
docs: Solo para los cambios en los documentos.
style: Cuando el cambio no afecta el código o la funcionalidad (Espacios en blanco, formato, punto y coma, etc), solo la estructura.
refactor: Cuando el cambio en el código no corrige un error o agrega una nueva funcionalidad. Mejora en el código.

Scope
Es el ámbito donde se realizó el cambio, config, web-server, index, modulo, etc. Si estas trabajando en Gitlab con incidencias, puedes asociar fácilmente el comentario con la incidencia agregando # y el número de esta, te dejo un repo como referencia https://gitlab.com/kairos6/api-kairos.

Subject
Contiene la descripción del cambio, se debe de utilizar en tiempo presente, máximo 100 caracteres.

Ultimos consejos:

Escribe los comentarios en inglés, esto le dará un plus a tu -repositorio.
Si trabajas con más personas, agrega esta información en el archivo de contribución para que tu equipo conozca como se tiene que crear los mensajes de los commits.
Tus commits deben de ser pequeños, es decir que contengan la menor cantidad de cambios, esto te ayudará a tener un mayor seguimiento de tus cambios.

Ya tienes todo para que tus proyectos sean muy profesionales, empieza ya a aplicar este formato a todos tus proyectos. Compárteme en mis redes sociales como lo aplicaste en tus commits o si tienes alguna otra forma de hacerlo.

Valor de una marca personal

Marco Elizalde — Sat, 24 Oct 2020 00:06:14 +0000

Todos tenemos algo que enseñar y ofrecer al mundo, empresas o clientes. Pero muchas veces subestimamos nuestros conocimientos, nuestras habilidades, el valor que tenemos y la importancia de tener y fortalecer una marca personal.

Actualmente vivimos en un mundo muy competitivo, y lleno de gente profesional como tú, con las cuales tienes que competir para lograr ocupar una vacante o ganar un nuevo cliente. Y es algo que la universidad no te prepara, no te da esa llave maestra para lograr obtener ese trabajo que soñaste, pero existe algo maravilloso con lo que puedes llegar a destacar entre los demás, tu marca personal.

Yo hasta hace muy poco desconocía que era una marca personal y el gran valor e importancia que tiene formar una. La marca personal es construir alrededor de nuestra persona una marca, con el objetivo de destacar sobre los demás de manera personal o profesional, con la cual generamos una presencia hacia un mercado o audiencia en específico. La marca personal nos ayuda a proyectarnos en los ojos de los demás.

Una gran ventaja de tener una marca personal es que nos da un valor agregado como profesionista al momento de buscar trabajo o clientes nuevos. Debido a que en la actualidad las personas que te buscan, cada vez están menos interesadas es tu hoja de vida, y más en lo que sabes hacer, lo que has logrado y todo aquello en lo que colaboras.

Y tú , ¿ya tienes tu marca personal? ¡Que esperas para empezar a crearla y crecer!

Espero que te sirva este pequeño artículo para orientarte un poco sobre la marca personal, y te invito a que me dejes tus comentarios.

Forem: Marco Elizalde

Cómo escribir excelentes commits

Valor de una marca personal