Nota: Las listas de tareas se encuentran en versión beta privada y están sujetas a cambios. Actualmente, hemos pausado la incorporación a la versión beta.
Introducción
En esta guía se muestra cómo usar listas de tareas para dividir un trabajo más grande en varias listas de tareas y varias subtareas. Aprenderás a crear una lista de tareas con la interfaz de usuario y con Markdown, cómo realizar cambios en una lista de tareas y cómo integrar nuevas listas de tareas en un proyecto.
Para demostrar cómo se pueden usar listas de tareas para dividir el trabajo en subtareas más pequeñas, esta guía seguirá un escenario en el que es necesario crear una página de aterrizaje para una nueva característica. Puedes seguir esta guía con tu propio escenario.
Requisitos previos
A medida que sigas esta guía, crearás varias incidencias en un repositorio. Necesitarás un repositorio donde puedas crear incidencias.
Creación de una incidencia para hacer un seguimiento del trabajo de agregar una nueva página de aterrizaje
En este paso, crearemos la incidencia primaria para hacer un seguimiento de las subtareas necesarias para publicar la nueva página de aterrizaje.
- Ve al repositorio donde quieres hacer el seguimiento del trabajo.
- Crea una incidencia en blanco con el título "incidencia de seguimiento de la página de aterrizaje". Para obtener más información, vea «Crear una propuesta».
Creación de la primera lista de tareas
Las listas de tareas se agregan al comentario de apertura de una incidencia (descripción de la incidencia). Las incidencias pueden contener varias listas de tareas con distintos títulos. Esta es una excelente manera de clasificar las subtareas.
- Ve a la incidencia que acabas de crear. Si aún no lo has hecho, presiona Enviar nueva incidencia.
- Al final de la descripción de la incidencia, haz clic en Agregar lista de tareas.
Esto insertará una lista de tareas vacía en la incidencia.
Adición de borradores de tareas
Los borradores de tareas son elementos de texto que se agregan a la lista de tareas. Los borradores de tareas aparecen en la lista de tareas con una casilla. Puedes usar borradores de tareas para esbozar rápidamente los requisitos y las subtareas de un proyecto y, opcionalmente, convertirlos más adelante en incidencias.
-
Si el campo de texto no tiene el foco, haz clic en Agregar elemento a tareas.
-
Agrega algunos borradores de tareas para esbozar este trabajo. Escribe el borrador de tarea y presiona Entrar después de cada uno.
Para nuestro escenario de página de aterrizaje de ejemplo, puedes agregar:
- "Diseñar una nueva página de aterrizaje"
- "Crear contenido para la página de aterrizaje"
- "Traducir el contenido a idiomas admitidos"
Conversión del borrador de una tarea en una incidencia
Puedes convertir los borradores de tareas en incidencias. Puedes convertir los borradores de tareas cuando estés listo para empezar a trabajar en una tarea determinada. Las incidencias se crean en el mismo repositorio que has usado para la incidencia de seguimiento.
-
Junto al borrador de la tarea "Diseñar una nueva página de aterrizaje", haz clic en .
-
Haz clic en Convertir en propuesta.
Asignación de ti mismo a la nueva incidencia
Ahora puedes asignarte a la nueva incidencia sin salir de la lista de tareas.
-
Junto a la incidencia "Diseñar una nueva página de aterrizaje" en la lista de tareas, haz clic en .
-
En el menú contextual, haz clic en Establecer usuarios asignados.
-
En la lista de personas, selecciónate a ti mismo.
También puedes usar este menú contextual para establecer etiquetas y agregar una incidencia a un proyecto.
Cambio de nombre de una lista de tareas
Puedes cambiar el título de una lista de tareas para que represente mejor las tareas de las que está haciendo un seguimiento. Esto es especialmente útil cuando tienes varias listas de tareas en la misma incidencia y quieres segmentar las tareas.
-
En la parte superior derecha de la lista de tareas, haz clic en .
-
En el menú, haz clic en Cambiar nombre.
-
Escribe un nuevo título para la lista de tareas y presiona Entrar.
Para nuestro escenario de página de aterrizaje de ejemplo, podrías cambiar el nombre de esta lista de tareas a "Contenido de la página de aterrizaje".
Creación de una lista de tareas con Markdown
Puedes crear varias listas de tareas en una única incidencia. Cada lista de tareas tiene su propio título y sus propias tareas. Para agregar listas de tareas, puedes usar el botón Agregar lista de tareas o escribir Markdown cuando editas la incidencia.
-
Al principio de la descripción de la incidencia (comentario de apertura), haz clic en .
-
En el menú, haz clic en Editar.
-
En la descripción de la incidencia, debajo de la primera lista de tareas, agrega el siguiente Markdown:
Markdown ```[tasklist] ### Tasks - [ ] Draft task ```
```[tasklist] ### Tasks - [ ] Draft task ```
-
Para cambiar el título de esta lista de tareas, escribe un nuevo título después de
###
. Por ejemplo, cambie### Tasks
a### Backend changes
.
En las dos secciones siguientes, realizaremos más cambios en el Markdown antes de guardar el comentario.
Adición de borradores de tareas usando Markdown
Puedes agregar rápidamente nuevos borradores de tareas escribiéndolos directamente en la lista de tareas con Markdown.
- Para agregar nuevos borradores de tareas, crea una nueva línea después de la última tarea y escribe
- [ ]
y la nueva tarea. Por ejemplo,- [ ] Sign-up form
. - Para editar el borrador de una tarea, modifica el texto que aparece después de
- [ ]
. Por ejemplo, cambie- [ ] Draft task
a- [ ] Database schema
.
Adición de incidencias que ya existen usando Markdown
También puedes hacer un seguimiento de las incidencias actuales agregándolas a la lista de tareas. Puedes agregar incidencias usando Markdown o en la interfaz de usuario pegando la dirección URL de la incidencia. Puedes agregar incidencias y solicitudes de incorporación de cambios desde cualquier repositorio al que tengas acceso.
- Comienza a escribir
- [ ]
en una nueva línea y pega la dirección URL completa de una incidencia. Por ejemplo:- [ ] https://github.com/octo-org/octo-repo/issues/45
- Haga clic en Update comment (Actualizar comentario).
Verás la segunda lista de tareas debajo de la primera.
Seguimiento del progreso
Las listas de tareas ayudan a ver rápidamente el estado y el progreso de las tareas de las que has elegido hacer un seguimiento.
- A la izquierda de uno de los borradores de tareas, activa la casilla para marcar esa tarea como realizada.
- Haz clic en la incidencia que habías convertido antes a partir de un borrador.
- En la incidencia convertida, al final de la página, haz clic en Cerrar incidencia.
Al volver a la lista de tareas y actualizar la página, puedes ver que la incidencia que acabas de cerrar ahora tiene un icono que indica que está cerrada. Al principio de la incidencia, debajo del título, se indica el progreso como "2 de 6 tareas".
Integración en un proyecto
Las relaciones que creas en las listas de tareas están disponibles en los proyectos. Puedes ver rápidamente el progreso alcanzado en cada incidencia, examinar las subtareas y configurar vistas que usen las listas de tareas.
-
Ve a un proyecto que pertenezca a la misma cuenta de usuario u organización que has usado para la lista de tareas y las incidencias. Si no tienes ningún proyecto disponible, puedes crear uno. Para obtener más información, vea «Creación de una instancia de proyecto».
-
Crea una nueva vista en el proyecto con un diseño de tabla. Para obtener más información sobre las vistas, consulta "Administración de las vistas".
-
Agrega una de las incidencias de las listas de tareas al proyecto. Para obtener más información sobre cómo agregar elementos a proyectos, consulta "Adición de elementos a proyecto".
-
Haz clic en junto al nombre de la vista abierta actualmente.
-
En el menú, haz clic en Agrupar por y selecciona Seguido por. Esto crea una vista en la que las incidencias se agrupan por la incidencia que está haciendo un seguimiento de ellas.
Las incidencias y las solicitudes de incorporación de cambios no se agregan automáticamente a un proyecto cuando se agregan a una lista de tareas. Al agrupar una vista por el campo "Seguido por", GitHub le indica que agregue otras incidencias asociadas a la lista de tareas.
- Si hay incidencias en las listas de tareas que no forman parte del proyecto, puede hacer clic en 1 elemento no está en este proyecto debajo del grupo.
- En la lista de incidencias, haz clic en la incidencia que quieres agregar. Si tienes varias incidencias, puedes agregarlas todas.
Conclusión
Después de seguir esta guía, has creado una incidencia de seguimiento con dos listas de tareas, has realizado cambios en esas listas de tareas en la interfaz de usuario y directamente con Markdown, has convertido el borrador de una tarea en una incidencia y has integrado los datos de la lista de tareas en un proyecto.
Para obtener más información sobre cómo administrar los elementos de la lista de tareas, consulta "Administración de tareas en una lista de tareas". Para obtener más información sobre la integración de listas de tareas en proyectos, consulta "Uso de proyectos y listas de tareas".