Skip to main content
Skip to content

Acerca de las listas de tareas

Puedes utilizar listas de tareas para desglosar el trabajo de una propuesta o solicitud de cambios en tareas más pequeñas y luego rastrear el conjunto de trabajos completo hasta que se finalicen.

¿Quién puede utilizar esta característica?

Markdown se puede usar en la interfaz web de GitHub.

Acerca de las listas de tareas

Importante

Los bloques de lista de tareas son retirado. Puede obtener más información sobre esto en el GitHub blog.

Puede usar subelementos en lugar de los bloques de lista de tareas. Las subtemas proporcionan una sección dedicada dentro de cada problema, lo que facilita rastrear el trabajo relacionado sin depender de Markdown. Para obtener más información sobre los subtemas, ve a Adición de subtareas.

Una lista de tareas es un conjunto de tareas que se muestran cada una en una línea separada con una casilla de verificación seleccionable. Puedes seleccionar o deseleccionar estas casillas de verificación para marcar las tareas como completas o incompletas.

Puede usar Markdown para crear una lista de tareas en cualquier comentario de GitHub. Si hace referencia a un problema, una solicitud de incorporación de cambios o una discusión en una lista de tareas, la referencia se desenfurcará para mostrar el título y el estado.

Acerca de las listas de tareas de propuestas

Si agregas una lista al cuerpo de una tarea, esta tendrá una funcionalidad agregada.

  • Para ayudarle a realizar un seguimiento del trabajo del equipo en un problema, el progreso de la lista de tareas de un problema aparece en varios lugares en GitHub, como la lista de problemas de un repositorio.
  • Si una tarea hace referencia a otra incidencia y alguien cierra dicha incidencia, la casilla de la tarea se marcará automáticamente como cumplida.
  • Si una tarea requiere un seguimiento o discusión adicionales, puede convertir la tarea en un problema si mantiene el puntero sobre la tarea y hace clic en la esquina superior derecha de la tarea. Para agregar más detalles antes de crear la propuesta, puedes utilizar los atajos de teclado para abrir un formato de propuesta nuevo. Para más información, consulta Atajos de teclado.
  • Cualquier propuesta que se referencia en la lista de tareas especificará que se rastrean en la propuesta de referencia.

Captura de pantalla de una propuestas que muestra una lista de tareas bajo el encabezado "Features". Tres elementos de la lista tienen un hipervínculo a otras propuestas.

Creación de listas de tareas

Para crear una lista de tareas, debe añadir como prefijo un guion y espacio, seguido de [ ] a los elementos de la lista. Para marcar una tarea como completada, use [x].

- [x] #739
- [ ] https://github.com/octo-org/octo-repo/issues/740
- [ ] Add delight to the experience when all tasks are complete :tada:

Captura de pantalla que muestra la versión representada de Markdown. Las referencias a problemas se representan como títulos del problema.

Nota:

No se pueden crear elementos de lista de tareas dentro de propuestas cerradas o propuestas con solicitudes de cambios vinculadas.

Volver a ordenar tareas

Puedes reordenar los elementos de una lista de tareas. En primer lugar, haz clic o mantén el puntero a la izquierda de la casilla de una tarea hasta que aparezca una cuadrícula de seis puntos. A continuación, arrastra y coloca la cuadrícula para mover la tarea a una nueva ubicación.

Puedes reordenar las tareas a lo largo de listas diferentes en el mismo comentario, pero no puedes volver a ordenar las tareas a lo largo de comentarios diferentes.

Captura de pantalla de una incidencia de GitHub que muestra dos tareas en una lista de tareas. Una cuadrícula de seis puntos a la izquierda de la segunda tarea está delineada en naranja oscuro.

Conversión de tareas en incidencias

También puedes convertir tareas en incidencias. En primer lugar, mantenga el puntero sobre uno de los elementos de la lista de tareas y, a continuación, haga clic en .

Captura de pantalla de un problema que muestra dos tareas. El icono "Convertir en incidencia" está destacado con un contorno naranja.

Cualquier propuesta que se referencie en una lista de tareas especificará que se rastrean por la propuesta que contiene la lista de tareas. Para ir a la propuesta rastreadora desde la propuesta rastreada, haz clic en el número de la propuesta rastreadora en la sección Tracked by junto al estado de la propuesta.

Captura de pantalla de la incidencia 3 que muestra el estado de la incidencia "Abierta" y el texto "Seguida por la incidencia nº 2", que aparece en naranja.