Acerca de las listas de tareas

Acerca de las listas de tareas

Las listas de tareas agregan compatibilidad con jerarquías de propuestas en GitHub Enterprise Cloud, lo que te ayuda a realizar un seguimiento de las propuestas, dividirlas en subtareas más pequeñas y crear nuevas relaciones entre ellas.

Las listas de tareas se basan en la iteración anterior de las listas de tareas beta, de forma que conservan la capacidad de convertir elementos en incidencias, mostrar el progreso de una lista de tareas y crear una relación de seguimiento entre incidencias.

Las incidencias que agregues a las listas de tareas se rellenarán automáticamente para mostrar sus personas asignadas y las etiquetas aplicadas.

Acerca de la integración con projects

El panel lateral del proyecto muestra el lugar de una incidencia en la jerarquía en un menú de ruta de navegación, lo que te permite desplazarte por las incidencias en las listas de tareas. También puedes agregar los campos Sigue y Seguido por a las vistas del proyecto para ver rápidamente las relaciones entre tus propuestas. Para más información, consulta "Acerca de los campos Sigue a y Seguido por".

Creación de listas de tareas con Markdown

Puedes crear una lista de tareas mediante Markdown en la descripción de la incidencia (el comentario de apertura de una incidencia). Puedes incluir vínculos a incidencias y solicitudes de incorporación de cambios o crear borradores de incidencias.

1. Para comenzar, crea una nueva incidencia o edita la descripción de una incidencia existente.
2. Para comenzar la lista de tareas, escribe ```[tasklist] (triples corchetes y tasklist entre corchetes cuadrados) en una nueva línea de la descripción de la incidencia.
3. Opcionalmente, escribe ### TITLE en la línea siguiente, pero reemplaza TITLE por un título de la lista de tareas.
4. Por cada elemento que quieras agregar a la lista de tareas, escribe - [ ] en una nueva línea, seguido de un espacio y un vínculo a una incidencia, un vínculo a una solicitud de incorporación de cambios o algún texto para crear el borrador de una incidencia.
   • Debes proporcionar un vínculo completo a una incidencia o a una solicitud de incorporación de cambios. Por ejemplo, https://github.com/octo-org/octo-repo/issues/45.
   • Se puede aplicar formato a las tareas con Markdown.
   • Las tareas no deben superar los 256 caracteres de longitud.
5. Para finalizar la lista de tareas, escribe ``` en una nueva línea después del último elemento.

La lista de tareas finalizada debe tener el siguiente aspecto:

```[tasklist]
### My tasks
- [ ] https://github.com/octo-org/octo-repo/issues/45
- [ ] Draft issue title
```

La lista de tareas se representará mediante GitHub Enterprise Cloud al guardar la incidencia. Después, puedes realizar cambios y agregar incidencias y borradores de incidencias mediante la interfaz de usuario de GitHub Enterprise Cloud. Si editas la descripción de la incidencia, podrás modificar el Markdown directamente o copiarlo para duplicar la lista de tareas en otras incidencias.

También puedes hacer clic en en la barra de herramientas de formato para insertar una lista de tareas al crear una nueva incidencia o editar una descripción de la incidencia.

Adición de incidencias a una lista de tareas

1. En la parte inferior de la lista de tareas, haz clic en Agregar elemento a tareas.

2. Selecciona la incidencia que se va a agregar a la lista de tareas.

   • Para agregar una propuesta actualizada recientemente desde el repositorio, haz clic en la propuesta en la lista desplegable o usa las teclas de dirección para seleccionarla y, después, presiona Entrar.
   • Para buscar una propuesta en el repositorio, empieza a escribir el título de una propuesta o su número y haz clic en el resultado, o usa las teclas de dirección para seleccionarla y presiona Entrar.
   • Para agregar una propuesta directamente mediante su dirección URL, pega la dirección URL de la propuesta y presiona Entrar.

Creación de borradores de incidencias en una lista de tareas

Los borradores de propuestas son útiles para capturar rápidamente ideas que más adelante puedes convertir en propuestas. A diferencia de las incidencias y las solicitudes de incorporación de cambios a las que se hace referencia desde los repositorios, los borradores de incidencias solo existen en la lista de tareas.

1. En la parte inferior de la lista de tareas, haz clic en Agregar elemento a tareas.
2. En el campo "Escriba para agregar un elemento o pegar una dirección URL de la incidencia", escriba el título del problema de borrador y presione Introducir.

Conversión de borradores de incidencias en incidencias de una lista de tareas

Puedes convertir los borradores de propuestas en propuestas. Las incidencias se crean en el mismo repositorio que la incidencia principal de la lista de tareas.

1. Junto al borrador de propuesta que quieras convertir, haz clic en el .

   

2. Haz clic en Convertir en propuesta.

Eliminación de una incidencia o borrador de incidencia de una lista de tareas

Puedes quitar incidencias y borradores de incidencias de la lista de tareas. Las incidencias quitadas de una lista de tareas no se quitan del repositorio.

1. Junto al borrador de propuesta que quiera eliminar, seleccione en el .

   

2. En el menú, haz clic en Quitar.

Cambio del título de una lista de tareas

Al crear una nueva lista de tareas, el título predeterminado es "Tareas". Para modificarlo, edita el markdown de la propuesta.

1. En la parte superior derecha del cuerpo del problema, seleccione y haga clic en Editar.

   

2. En el bloque de código cercado que comienza por ```[tasklist], add a header with your new title, such as `## Mi nuevo título".

   

3. Haga clic en Update comment (Actualizar comentario).

Copiado de una lista de tareas

Al copiar la lista de tareas con la opción "Copiar Markdown", GitHub Enterprise Cloud copia el Markdown en el Portapapeles e incluye el nombre de la incidencia para que puedas pegar la lista de tareas fuera de GitHub sin perder contexto.

1. En la parte superior derecha de la lista de tareas, haz clic en .

   

2. En el menú, haz clic en Copiar markdown.