Skip to main content
Publicamos actualizaciones para la documentación con frecuencia y es posible que aún se esté traduciendo esta página. Para obtener la información más reciente, consulta la documentación en inglés.

Planear y rastrear el trabajo para tu equipo o proyecto

Lo básico para utilizar las herramientas de planeación y rastreo de GitHub para dministrar el trabajo en un equipo o proyecto.

Introducción

Puedes utilizar los repositorios de GitHub, las propuestas, los tableros de proyecto y otras herramientas para rastrear y planear tu trabajo, ya sea que trabajes en un proyecto individual o en un equipo inter-funcional.

En esta guía, aprenderá a crear y configurar un repositorio para colaborar con un grupo de personas, crear plantillas de incidencias y formularios, abrir incidencias y a usar listas de tareas para dividir el trabajo y establecer un panel 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, vea "Creación de un repositorio".

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, vea "Creación de un repositorio solo de incidencias".

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, vea "Acerca de los archivos Léame".

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, vea "Establecimiento de instrucciones para los colaboradores del repositorio".

Ejemplo de README

Podemos crear un README.md para introducir nuestro proyecto nuevo al Proyecto Octocat.

Ejemplo de cómo crear un README

Crear plantillas de reporte de problemas

Puedes utilizar las propuestas para rastrear los tipos de trabajo diferentes que tu equipo o proyecto inter-funcional cubre, así como para recopilar información de aquellos fuera de 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 propuesta para rastrear el progreso en un proyecto de iniciativa grande, el cual se enlaza a propuestas más pequeñas.
  • Solicitudes de características: Tu equipo o usuarios pueden crear propuestas para solicitar una mejora en tu producto o proyecto.
  • Errores: Tu equipo o usuarios pueden crear propuestas para reportar un error.

Dependiendo del tipo de repositorio y proyecto en el que estés trabajando, podrías priorizar ciertos tipos de propuestas osbre otras. Una vez que haya identificado los tipos de incidencia más comunes para el equipo, puede crear plantillas de incidencias y formularios para el repositorio. Las plantillas de incidencias y los formularios permiten crear una lista estandarizada de plantillas entre las que puede elegir un colaborador cuando abra una incidencia en el repositorio. Para más información, vea "Configuración de plantillas de incidencia para el repositorio".

Ejemplo de plantilla de propuesta

A continuación, creamos una plantilla de propuesta para reportar un error en el Proyecto Octocat.

Ejemplo de cómo crear una plantilla de propuesta

Ahora que creamos la plantilla de propuestas para reportes de errores, puedes seleccionarla cuando crees una propuesta nueva en el proyecto Octocat.

Ejemplo de elegir la plantilla de una propuesta

Abrir propuestas y utilizar las listas de tareas para rastrear el trabajo

Puedes organizar y rastrear tu trabajo creando propuestas. Para más información, vea "Creación de una incidencia".

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 creación de propuesta para una iniciativa grande

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. Las listas de tareas tienen una funcionalidad adicional cuando se agregan al cuerpo de una incidencia. Puede ver la cantidad de tareas que se han completado con respecto al total en la parte superior de la incidencia y, si alguien cierra una incidencia vinculada enlazada en la lista de tareas, la casilla se marcará automáticamente como completada. Para más información, vea "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.

Agregar una lista de tareas a un ejemplo de propuesta

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 propuestas son útiles cuando las creas para debatir detalles específicos, tales como reportes de rendimiento o de errores, planeaciones para el siguiente trimestre o diseño para una iniciativa nueva. Los debates son útiles para la lluvia de ideas abierta o para la retroalmientación, fuera de la base de código y a través de los repositorios. Para más información, vea "¿Qué herramienta de debate debo usar?".

Como equipo, puedes comunicar actualziaciones sobre las tareas del día a día dentro de las propuestas para que todos sepan el estado del trabajo. Por ejemplo, puedes crear una propuesta para una característica grande en la que estén trabajando varias personas y cada miembro puede agregar actualizaciones con su estado o preguntas abiertas en esa propuesta.

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 la propuesta del Proyecto Octocat.

Colaborar con el ejemplo de propuesta

Utilizar etiquetas para resaltar las metas y el estado del proyecto

Puedes crear etiquetas para que un repositorio categorice las propuestas, solicitudes de cambio y debates. 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, vea "Creación de una etiqueta".

Una vez que hayas creado una etiqueta en un repositorio, puedes aplicarla a cualquier propuesta, solicitud de cambos o debate en este. Puedes entonces filtrar las propuestas y solicitudes de cambio 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, vea "Filtrado y búsqueda de incidencias y solicitudes de incorporación 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.

Agregar una etiqueta a un ejemplo de propuesta

Agregar propuestas a un tablero de 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 propuestas y solicitudes de cambvios 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 proyectos".

Ejemplo de proyecto

Aquí tienes el diseño de tabla de un proyecto ejemplo, la cual se llenó con propuestas del proyecto Octocat que hemos creado.

Ejemplo de diseño de tabla de proyectos

También podemos ver el mismo proyecto como un tablero.

Ejemplo de diseño de panel de proyectos

También puedes usar las instancias de projects (classic) de GitHub para planificar y realizar el seguimiento de tu trabajo y el del equipo. Los tableros de proyecto están compuestos por propuestas, solicitudes de extracción y notas que se categorizan como tarjetas en columnas a tu elección. Puedes crear tableros de proyecto para presentar trabajo, planes de alto nivel o incluso listas de verificación. Para más información, vea "Acerca de los paneles de proyecto".

Ejemplo del trablero de proyecto

A continuación, se presenta un tablero de proyecto para nuestro ejemplo del Proyecto Octocat, con la propuesta que creamos y las propuestas más pequeñas en las que lo dividimos agregadas a este.

Ejemplo del trablero de proyecto

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.