Introducción
Puede utilizar los repositorios de GitHub, las propuestas, los proyectos y otras herramientas para rastrear y planear su trabajo, ya sea que trabaje en un proyecto individual o en un equipo inter-funcional.
En esta guía, aprenderás a crear y configurar un repositorio para colaborar con un grupo de personas, crear plantillas de incidencias y formularios, abrir incidencias y desglosar el trabajo, y a establecer una instancia de proyecto para organizar las incidencias y realizar su seguimiento.
Crear un repositorio
Cuando comienzas un proyecto, inciativa o característica nuevos, el primer paso es crear un repositorio. Los repositorios contienen todos los archivos de tu proyecto y te proporcionan un lugar para colaborar con otros y administrar tu trabajo. Para más información, consulta Crear un repositorio nuevo.
Puedes configurar repositorios para propósitos diferentes con base en tus necesidades. Los siguientes son algunos casos de uso común:
-
**Repositorios de producto**: las organizaciones más grandes que realizan el seguimiento de su trabajo y objetivos sobre productos específicos tienen uno o más repositorios que contienen el código y otros archivos. Estos repositorios también pueden utilizarse para documentación, reportes sobre la salud de los productos o planes futuros para estos. -
**Repositorios de proyectos**: puede crear un repositorio para un proyecto individual en el que trabaje, o bien para uno en el que colabore con otras personas. Para una organización que rastrea el trabajo para iniciativas o proyectos de vida corta, tales como una firma de consultores, se necesita reportar la salud de un proyecto y mover a las personas entre proyectos diferentes con base en sus habilidades y necesidades. El código del proyecto a menudo se contiene en un solo repositorio. -
**Repositorios de equipo**: para una organización que agrupa personas en equipos y les proporciona proyectos, como un equipo de herramientas de desarrollo, es posible que el código esté distribuido entre varios repositorios para los diferentes trabajos de los que tengan que realizar el seguimiento. En este caso, puede resultar útil tener un repositorio específico del equipo como un solo lugar para realizar el seguimiento del trabajo en el que participa el equipo. -
**Repositorios personales**: puede crear un repositorio personal para realizar el seguimiento de todo el trabajo en un solo lugar, planificar tareas futuras o incluso agregar notas o información que quiera guardar. También puedes agregar colaboradores si quieres compartir esta información con otros.
Puedes crear repositorios múltiples y separados si quieres tener permisos de acceso diferentes para el código fuente y para rastrear propuestas y debates. Para más información, consulta Crear un repositorio solo para propuestas.
Para los ejemplos siguientes en esta guía, utilizaremos un repositorio de ejemplo llamado Proyecto Octocat.
Comunicar la información del repositorio
Puedes crear un archivo de README.md para tu repositorio e introducir tu equipo o proyecto y comunicar información importante sobre este. A menudo, un README es el primer elemento que verá un visitante de tu repositorio, así que también puedes proporcionar información de cómo los usuarios o contribuyentes pueden iniciar con el proyecto y de cómo contactar al equipo. Para más información, consulta Acerca del archivo LÉAME del repositorio.
También puedes crear un archivo de CONTRIBUTING.md, específicamente para que contenga los lineamientos sobre cómo los usuarios o contribuyentes pueden interactuar o contribuir con el proyecto, con instrucciones tales como cómo abrir una propuesta para arreglar un error o cómo solicitar una mejora. Para más información, consulta Configurar pautas para los colaboradores de repositorios.
Ejemplo de README
Podemos crear un README.md para introducir nuestro proyecto nuevo al Proyecto Octocat.
Crear plantillas de reporte de problemas
Puedes utilizar los problemas para rastrear los diferentes tipos de trabajo que tu equipo interfuncional o proyecto cubre, así como para recopilar información de personas externas a tu proyecto. Los siguientes son algunos casos de uso comunes para las propuestas.
- Liberar el rastreo: Puedes utilizar una propuesta para rastrear el progreso para un lanzamiento o para los pasos a completar el día del lanzamiento.
- Iniciativas grandes: Puedes utilizar una incidencia para rastrear el progreso en una gran iniciativa o proyecto, el cual se enlaza a incidencias más pequeñas.
- Solicitudes de características: Tu equipo o usuarios pueden crear propuestas para solicitar una mejora en tu producto o proyecto.
- Bugs: Tu equipo o usuarios pueden crear incidencias para reportar un fallo.
Dependiendo del tipo de repositorio y proyecto en el que estés trabajando, podrías priorizar ciertos tipos de problemas sobre otros. Una vez que hayas identificado los tipos de incidencia más comunes para tu equipo, puedes crear plantillas de incidencias y formularios para tu repositorio. Las plantillas de incidencias y los formularios te permiten crear una lista estandarizada de plantillas que un colaborador puede elegir cuando abra una incidencia en tu repositorio. Para más información, consulta Configurar las plantillas de reporte de problemas para tu repositorio.
Ejemplo de plantilla de propuesta
A continuación, creamos una plantilla de propuesta para reportar un error en el Proyecto Octocat.
Ahora que creamos la plantilla de propuestas para reportes de errores, puedes seleccionarla cuando crees una propuesta nueva en el proyecto Octocat.
Apertura de incidencias y desglose del trabajo
Puedes organizar y rastrear tu trabajo creando incidencias. Para más información, consulta Crear un problema.
Ejemplo de propuesta
Aquí tienes un ejemplo de una propuesta que se creó para un trabajo de cara al usuario de una iniciativa grande en el proyecto Octocat.
Ejemplo de subproblemas
Puedes agregar subincidencias a una incidencia para dividir rápidamente partes más grandes del trabajo en incidencias más pequeñas. Las subincidencias agregan compatibilidad con jerarquías de incidencias en GitHub mediante la creación de relaciones entre las incidencias. Puede crear varios niveles de subincidencias que representen con precisión el proyecto si divide las tareas exactamente con el nivel de detalle que usted y el equipo necesitan. Consulta Adición de subtareas y Exploración de subtemas.
Puedes usar tipos de incidencias para clasificar el trabajo en repositorios de toda la organización, como tareas, errores y características. Consulta Administración de tipos de incidencias en una organización.
Ejemplo de lista de tareas
Puedes utilizar listas de tareas para dividir propuestas más grandes en otras más pequeñas y para rastrear propuestas como parte de una meta más grande. Para más información, consulta Acerca de las listas de tareas.
Debajo, agregamos una lista de tareas a nuestra propuesta del Proyecto Octocat, dividiéndola en propuestas más pequeñas.
Ejemplo de etiqueta
A continuación se muestra un ejemplo de una etiqueta front-end que se ha creado y agregado a la incidencia.
Representación de qué incidencias bloquean o están bloqueadas por otros trabajos
Al crear dependencias de incidencias, puedes ver y comunicar fácilmente qué incidencias están bloqueadas por otras, o bien bloquean otras incidencias. Esto ayuda a simplificar la coordinación, evitar cuellos de botella y aumentar la transparencia en todo el equipo. Consulta Creación de dependencias de incidencias.
Tomar deciciones como equipo
Puedes utilizar las propuestas y debates para comunicarte y hacer decisiones como equipo sobre las mejoras planeadas o sobre las prioridades de tu proyecto. Las incidencias son útiles cuando las creas para discutir detalles específicos, tales como informes de errores o de rendimiento, planificación para el próximo trimestre o diseño para una nueva iniciativa. Los debates son útiles para el brainstorming abierto o para la retroalimentación, fuera de la base de código y entre los repositorios. Para más información, consulta Comunicarse con GitHub.
Como equipo, también podéis comunicar actualizaciones sobre las tareas del día a día dentro de los problemas para que todos sepan el avance del trabajo. Por ejemplo, puedes crear una incidencia para una funcionalidad extensa en la que estén trabajando varios miembros del equipo, y cada integrante puede agregar actualizaciones con su estado o preguntas pendientes en esa incidencia.
Ejemplo de propuesta con colaboradores de proyecto
Aquí tienes un ejemplo de los colaboradores de proyecto dando una actualización de estado sobre su trabajo en el problema del Proyecto Octocat.
Utilizar etiquetas para resaltar las metas y el estado del proyecto
Puedes crear etiquetas para categorizar incidencias, solicitudes de extracción y discusiones en un repositorio. GitHub también proporciona etiquetas predeterminadas para cada repositorio nuevo que puedas editar o borrar. Las etiquetas sirven para rastrear las metas del proyecto, los errores, los tipos de trabajo y el estado de una propuesta.
Para más información, consulta Administrar las etiquetas.
Una vez que hayas creado una etiqueta en un repositorio, puedes aplicarla a cualquier incidencia, solicitud de cambios o debate en el repositorio. Entonces puedes filtrar incidencias y pull requests por etiqueta para encontrar todo el trabajo asociado. Por ejemplo, para buscar todos los errores de front-end del proyecto, filtre por incidencias con las etiquetas front-end y bug. Para más información, consulta Filtrar y buscar propuestas y solicitudes de cambios.
Ejemplo de etiqueta
A continuación se muestra un ejemplo de una etiqueta front-end que se ha creado y agregado a la incidencia.
Incorporación de propuestas a proyecto
Puedes usar projects en GitHub para planificar y realizar el seguimiento del trabajo de tu equipo. Un proyecto es una hoja de cálculo personalizada que se integra con tus incidencias y solicitudes de cambios en GitHub, y que se actualiza automáticamente con la información de GitHub. Puedes personalziar el diseño si filtras, clasificas y agrupas tus propuestas y solicitudes de cambios. Para empezar a trabajar con proyectos, consulta Inicio rápido para Projects.
Ejemplo de proyecto
Aquí tienes el diseño de la tabla de un proyecto de ejemplo, que hemos llenado con las incidencias del proyecto Octocat que hemos creado.
También podemos visualizar el mismo proyecto como un tablero.
Pasos siguientes
Ya aprendiste sobre las herramientas que ofrece GitHub para planear y rastrear tu trabajo e iniciaste en la configuración de un equipo inter-funcional o repositorio de proyecto. Aquí te mostramos algunos recursos útiles para seguir personalizando tu repositorio y organizar tu trabajo.
-
[AUTOTITLE](/repositories/creating-and-managing-repositories/about-repositories) para más información sobre la creación de repositorios -
[AUTOTITLE](/issues/planning-and-tracking-with-projects/learning-about-projects) para obtener más información sobre los proyectos -
[AUTOTITLE](/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/changing-the-layout-of-a-view) para aprender a personalizar vistas para proyectos -
[AUTOTITLE](/issues/tracking-your-work-with-issues) para obtener más información sobre las diferentes formas de crear y gestionar incidencias -
[AUTOTITLE](/communities/using-templates-to-encourage-useful-issues-and-pull-requests/about-issue-and-pull-request-templates) para más información sobre las plantillas de incidencias -
[AUTOTITLE](/issues/tracking-your-work-with-issues/using-issues/managing-issue-types-in-an-organization) para administrar tipos de incidencias -
[AUTOTITLE](/issues/using-labels-and-milestones-to-track-work/managing-labels) para aprender a crear, editar y eliminar etiquetas -
[AUTOTITLE](/issues/tracking-your-work-with-issues/using-issues/adding-sub-issues) para obtener información sobre cómo agregar subincidencias -
[AUTOTITLE](/get-started/writing-on-github/working-with-advanced-formatting/about-task-lists) para más información sobre listas de tareas