Startup to Dogger project!

[stariluz]

👋 Bienvenidx!

Nos da gusto que te unas a este proyecto. A fin de que te familiarices con nuestra metodología de trabajo, redactamos esta guia.
Trataré de ser tan breve como pueda serlo para tu introducción.

Empecemos.

Video Tutorial 1. Familiarizandote con GitHub

Este video resume lo que se encuentra en esta guía.

Projects

En la pestaña con el nombre Projects puedes visualizar todos los proyectos que pertenecen a este repositorio:

Aqui debes dar click al proyecto que desees o debas cooperar [que para este caso es el proyecto Dogger

Ahora verás todas las tarjetas y actividades que se tienen planeadas para trabajarlas, que se estan trabajando, o bien que ya se hayan completado.

Novatxs

Si recién inicias y no tienes suficiente conocimiento de los proyectos ni de tus habilidades, lx líder de túi equipo te designará tus tareas, que identificarás con tu foto de perfil que se encuentra en la parte superior derecha de cada tarjeta.

Al dar click sobre el titulo de la tarjeta, veras toda la información que hasta ahora tiene dicha tarea.

Presta atención a este apartado:

Punto por punto

• Priority. Quiere decir que tanta prioridad tiene la realizacion de esta tarjeta. Una prioridad de P0 quiere decir que son las tarjetas mas importantes y por las generalmente deberías empezar a trabajar. Una prioridad de P2 quiere decir que la tarjeta no requiere atención inmediata o bien, no son componentes principales del proyecto, por lo que usualmente son las últimas que se realizan en un sprint.
• Size. Que tan grandes son los cambios estimados que implicarán completar la tarea. Se utiliza para señalar si se espera que se realicen muchas modificaciones durante la tarea, o bien, se espera que sean pocas. Generalmente las tareas con un gran tamaño deberían de implicar mucho esfuerzo por lo que se les encargarían a compañerxs avanzadxs en el ámbito de la tarjeta.
• Estimate. Lo usamos como una medida estimada del esfuerzo que implica para unx colaboradxr promedio realizar la tarjeta. Un estimado bajo implíca que se esperan pocas dificultades en la resolución de la tarjeta, mientras que un estimado alto implica que se esperan muchas dificultades o retrasos en la compleción de la tarjeta. El esfuerzo estimado incluye todo el proceso de investigación (o inspiración), desarrollo (o diseño) y debugging requerido. Con el paso del tiempo, podremos tener promedios de cuanto avancé o esfuerzo puede realizar cada compañerx en cada sprint.
• Iteration. Es el ciclo de trabajo en el cual se espera realizes la tarjeta. Una iteración corresponde a un sprint. El sprint actualmente dura una semana (de sabado a viernes). Se espera que logres completar todas tus actividades estimadas para la iteración actual, y con el tiempo y con la ayuda del ajuste del estimado, se te asignará cada iteración el trabajo a realizar. Si no completas la tarjeta a tiempo, se desplazará al sprint siguiente.
• Start date. La fecha en que empiezas a trabajar en la tarea asignada en la tarjeta. La debes asignar tu al empezar a trabajar.
• End date. La fecha en que terminaste la tarea. La debes asignar tu al terminar de trabajar.

Old School

Tienes suficiente conocimiento de los proyectos y de como trabajamos así que las tarjetas las podrás agregar tu mismx, asignartelas, indicar la descripción de la tarea así como todos los elementos de trabajo de la misma:

Trabajar en una tarjeta

En la parte inferior derecha, podras encontrar el siguiente apartado (con más o menos opciones dependiendo de que rol poseas en el proyecto). Aqui daremos click a Convert to issue:

Buscas el repositorio correspondiente [en este caso guauf-jam-dogs], y le das click:

Esto actualizará la interfaz:

Lo importante es deslizar la pantalla para abajo, y ver los nuevos apartados, en los cuales, daremos click al enlace azul con la leyenda Create a branch:

Se abre un dialogo en medio de la pantalla con la configuración que tendra la nueva rama:

• Branch name. Generalmente si no es que siempre, debemos dejar el nombre por default. El nombre contiene el numero asociado al issue (o en palabras entendibles, es como el identificador de la tarea), y contiene el titulo del issue (por ende de la tarea).
• Repository destination. El repositorio al cual este asociada la rama. Por defecto es el repositorio donde se crean el issue. A menos que se te indique lo contrariio, no deberás cambiarlo.
• Branch source. Generalmente, será main, valor indicado por defecto, mas no obstante, es muy probable que en algun momento tengas que partir de una rama que se creo para resolver otra tarea.

Important

En caso de que la persona encargada de code review y/o testing (rol que actualmente cubro yo, @stariluz) no este disponible para aprobar tus cambios, deberas avanzar en tus actividades partiendo de las ramas de las tareas previas, a fin de que no te atrases en tu trabajo o demores demasiado tiempo esperando. De requerir cambios realizados por otrxs integrantes, siempre puedes hacer un merge de su rama a tu rama. En caso de que batalles en este proceso, debes preguntar, de lo contrario no aceptaremos esta razón como impedimento en tus dailes.

Por último, dependiendo de que medio utilices para manejar tu repositorio, (el recomendado es Github Desktop), seleccionas la opción. En este caso seleccionamos el recomendado y damos click en create branch.

En la alerta que aparece, da click en Open GitHubDesktop.exe:

Lo cual abre la aplicación, y podras notar en esta parte señalada, que ya esta seleccionada la rama en la que trabajarás:

Continuará...