Lista de verificación: Reglas de redacción, colocación y ejemplos

Una lista de verificación es un conjunto finito de acciones independientes o puntos de verificación que el lector puede marcar como incompleto o completo. Su estado comprobable es parte del significado: completar cada elemento requerido debe demostrar que una tarea, revisión o condición de preparación designada está terminada.

Este ejemplo renderizado tiene un alcance delimitado, cuatro acciones concisas, estados visibles sin marcar y una condición de finalización. Convertir las mismas palabras a viñetas decorativas eliminaría la promesa de que el conjunto puede terminarse.

Por qué es importante este elemento

Los lectores utilizan una lista de verificación para externalizar la memoria. En lugar de tener que recordar cada requisito mientras alternan entre un borrador, el navegador, el diseño y la interfaz de publicación, pueden inspeccionar una condición a la vez y registrar el progreso. El límite finito reduce la incertidumbre: el lector sabe qué queda, qué significa «listo» y cuándo es seguro continuar.

Ese contrato psicológico es más sólido que «aquí hay algunas ideas útiles». Una casilla de verificación invita al compromiso, mientras que el último elemento sin marcar crea una tensión deliberada. Por lo tanto, el elemento debe ser honesto sobre su alcance. Si la lista omite un punto de verificación requerido o incluye aspiraciones vagas como «mejorar la página», la interfaz indica una certeza que el contenido no ha ganado.

La extractabilidad automatizada es la capacidad de los motores de búsqueda, los sistemas de respuesta de IA, la tecnología de asistencia y las herramientas de publicación para aislar cada elemento sin perder su función o modelo de finalización. Una lista de verificación tipificada expone una colección con nombre, límites de elementos estables, estados iniciales y una condición de finalización. Un analizador puede distinguir los puntos requeridos de los ejemplos o beneficios, mientras que un sistema de IA puede citar una acción autocontenida con el tema de la lista de verificación intacto.

Siga las reglas de redacción de elementos antes de elegir el componente. Su regla de precedencia es semántica: cuando el propósito de un bloque es ser completado o verificado, use el elemento de lista de verificación incluso si las viñetas comunes podrían mostrar las mismas palabras. La semejanza visual no preserva el estado, la validación, la accesibilidad ni el mapeo del adaptador.

Cuándo usarla

Utilice una lista de verificación cuando el conjunto sea finito, cada elemento pueda pasar o fallar de forma independiente y completar los elementos requeridos establezca una condición significativa. Los temas apropiados incluyen revisión previa a la publicación, requisitos de adquisición, preparación para migración, traspaso de incidentes, integridad de documentos, revisión de accesibilidad e inspección de mantenimiento recurrente.

Aplique tres pruebas:

1. Prueba de estado: ¿Puede cada elemento marcarse inequívocamente como incompleto o completo?
2. Prueba de límite: ¿La lista contiene todas las verificaciones requeridas para su alcance declarado?
3. Prueba de finalización: ¿Completar los elementos requeridos demuestra un resultado con nombre?

Si alguna respuesta es negativa, probablemente otro elemento sea más preciso. Los errores comunes cercanos son:

• Una lista con viñetas agrupa hechos, opciones, ejemplos o atributos. Sus elementos no son tareas y el conjunto no se completa.
• Una lista de pasos codifica una secuencia dependiente. Si mover el elemento 4 antes del elemento 2 puede causar fallos, los números y las guías de recuperación importan más que las casillas de verificación.
• Una lista de características describe lo que un producto tiene. «Admite exportación CSV» no es una verificación a menos que el lector esté verificando un requisito establecido.
• Una lista de deseos registra preferencias cuyos límites y prioridad pueden cambiar. No debe prometer finalización.
• Una tabla de puntuación evalúa dimensiones en una escala. Los estados binarios de verificación descartarían grados útiles de rendimiento.
• Un procedimiento largo con una casilla de verificación junto a cada clic confunde la ejecución con la verificación. Explique el procedimiento como pasos, luego añada una lista de verificación de finalización corta.

No use una lista de verificación como decoración al final de cada sección. Las casillas sin marcar repetidas imponen trabajo e implican que el lector no ha terminado, incluso cuando el contenido solo ofrecía consejos opcionales.

Dónde colocarla

La colocación sigue el momento en que el lector puede actuar o verificar. Introduzca primero la tarea, el alcance y el contexto necesario; luego coloque la lista de verificación inmediatamente antes de la decisión que controla o inmediatamente después del material que resume.

• Coloque una lista de verificación de preparación después de los prerrequisitos y antes de una acción irreversible o costosa.
• Coloque una lista de verificación de garantía de calidad después del borrador, configuración o procedimiento que evalúa y antes de la aprobación o publicación.
• Coloque una lista de verificación de requisitos de compra después de que se expliquen las necesidades y restricciones, pero antes de preseleccionar productos.
• Coloque una lista de verificación de inspección recurrente dentro de la sección de mantenimiento, junto a su cadencia y responsable.
• Coloque la lista de verificación principal cerca del inicio de un artículo de lista de verificación dedicado, después de una breve declaración de alcance, luego explique los elementos difíciles debajo.

Una lista de verificación no debe estar directamente junto a una segunda lista de verificación con alcance superpuesto; fúsionelas o asigne a cada una un encabezado y condición de finalización distintos. No la coloque junto a una lista de pasos secuencial sin indicar qué bloque es el procedimiento y cuál es la verificación. No debe dividir una advertencia de la consecuencia o respuesta requerida, interrumpir una tabla comparativa, ni colocarse dentro de una llamada a la acción. Nunca coloque un botón promocional entre el elemento final y la condición de finalización.

Anatomía

Las regiones etiquetadas son:

1. Encabezado de alcance: nombra el objeto y la decisión exactos, como «Verificación de enlaces previa a la publicación».
2. Instrucción: indica qué permite o demuestra la finalización.
3. Control de casilla de verificación: expone el estado incompleto o completo programática y visualmente.
4. Etiqueta de acción: comienza con un verbo concreto y se mantiene comprensible por sí misma.
5. Calificador opcional: proporciona un umbral, ubicación, responsable o requisito de evidencia.
6. Indicador de requerido: distingue los elementos opcionales solo cuando el contrato realmente lo permite.
7. Resumen de progreso: reporta elementos completados y totales requeridos en variantes interactivas.
8. Condición de finalización: establece el resultado alcanzado cuando todos los elementos requeridos pasan.

Las palabras siguen siendo la autoridad. Un icono de marca, una fila verde o una etiqueta tachada pueden reforzar el estado, pero ninguno puede reemplazar el estado marcado nativo o programático.

Ejemplos de diseño

Lista de verificación editorial estática

Utilice controles visibles sin marcar para una lista de verificación imprimible o de referencia. El lector puede copiarla o imprimirla, pero la página no afirma guardar el progreso.

Lista de verificación de progreso interactiva

Úsela cuando el lector se beneficie de marcar el progreso durante una sesión. Anuncie el recuento sin mover el foco y proporcione una acción clara de reinicio.

Lista de verificación con elementos requeridos y opcionales

Úsela solo cuando las tareas opcionales realmente no afecten la condición de finalización. Etiquete los elementos opcionales en texto; nunca dependa de un color más claro.

Lista de verificación agrupada

Para más de diez verificaciones totales, divida el trabajo en grupos de cuatro a diez con encabezados separados y condiciones de finalización propias. Cada grupo es comprensible de forma independiente.

Estado de impresión

La salida impresa debe conservar las marcas vacías y completadas en blanco y negro, mantener las etiquetas junto a sus controles y evitar dividir un grupo corto entre páginas.

Parámetros

El valor inicial de checked es para ejemplos prácticos, plantillas guardadas o estado de tarea propiedad del servidor. Las listas de verificación editoriales comienzan sin marcar; los autores nunca deben pre-marcar un elemento solo para crear una captura de pantalla más atractiva. Si interactive=false, persist debe ser none.

Sintaxis y ejemplos de código

El mapeo canónico sigue las reglas de precedencia, cuerpo y elementos anidados del contrato base. El elemento principal proporciona el comportamiento de colección; cada elemento proporciona una etiqueta, detalle opcional y campos de estado.

Directiva Markdown portátil

:::checklist{id="pre-publish-links" interactive=true persist=local}
## Pre-publish link check

Complete every required item before approving the page.

::item
### Open every internal link and confirm the destination exists
::

::item
### Confirm each anchor describes its destination out of context
::

::item{required=false}
### Check campaign parameters on optional promotional links
::

::item
### Verify keyboard focus is visible on every linked control
::

Complete when every required item passes and no exception remains.
:::

Shortcode de Hugo

{{< checklist id="pre-publish-links" title="Pre-publish link check" interactive="true" persist="local" completion="Complete when every required item passes and no exception remains." >}}
{{< checklist-item >}}Open every internal link and confirm the destination exists.{{< /checklist-item >}}
{{< checklist-item >}}Confirm each anchor describes its destination out of context.{{< /checklist-item >}}
{{< checklist-item required="false" >}}Check campaign parameters on optional promotional links.{{< /checklist-item >}}
{{< checklist-item >}}Verify keyboard focus is visible on every linked control.{{< /checklist-item >}}
{{< /checklist >}}

Esta es la forma requerida del adaptador de Hugo, no una afirmación de que el repositorio ya proporciona el shortcode. Hasta que exista un renderizador registrado, use HTML semántico para un ejemplo en vivo en lugar de imitar el componente con estilos no relacionados.

Bloque de WordPress

<!-- wp:amicited/checklist {"id":"pre-publish-links","title":"Pre-publish link check","interactive":true,"persist":"local","completion":"Complete when every required item passes and no exception remains."} -->
<!-- wp:amicited/checklist-item -->
<p>Open every internal link and confirm the destination exists.</p>
<!-- /wp:amicited/checklist-item -->
<!-- wp:amicited/checklist-item -->
<p>Confirm each anchor describes its destination out of context.</p>
<!-- /wp:amicited/checklist-item -->
<!-- wp:amicited/checklist-item {"required":false} -->
<p>Check campaign parameters on optional promotional links.</p>
<!-- /wp:amicited/checklist-item -->
<!-- wp:amicited/checklist-item -->
<p>Verify keyboard focus is visible on every linked control.</p>
<!-- /wp:amicited/checklist-item -->
<!-- /wp:amicited/checklist -->

Todos los adaptadores deben preservar el orden de origen, el estado requerido, las etiquetas visibles, la condición de finalización y el contenido sin marcar cuando los scripts no estén disponibles.

Ejemplos

Bueno: una verificación de lanzamiento delimitada

• Confirme que la versión del lanzamiento coincida con el registro de cambio aprobado.
• Ejecute la prueba de humo documentada y adjunte su resultado.
• Verifique que el responsable de la reversión esté disponible durante la ventana de lanzamiento.
• Registre la hora de implementación en la línea de tiempo del incidente.

Completo cuando: los cuatro registros están presentes y el responsable de la reversión nombrado ha confirmado la ventana.

Esto funciona porque cada elemento comienza con una acción observable, se mantiene dentro de una decisión de lanzamiento y tiene evidencia binaria. La línea de finalización explica lo que demuestra el conjunto completo.

Malo: una lista de contenido aspiracional

• Piense en la audiencia.
• Haga el artículo atractivo.
• Mejore el SEO.
• Añada cualquier otra cosa que ayude.

Esto falla porque ninguno de los elementos define una condición de aprobación, «cualquier otra cosa» hace que el conjunto sea infinito y marcar las casillas no demostraría que el artículo está listo. Reemplace las aspiraciones con puntos de verificación verificables como «Nombre una audiencia principal en el resumen» o traslade las indicaciones no accionables a la prosa.

Marcado Schema y accesibilidad

No existe un tipo Checklist general de Schema.org. No asigne verificaciones independientes a HowToStep a menos que la página describa genuinamente un procedimiento ordenado y el contenido visible contenga esos pasos. Una lista de verificación puede permanecer como contenido visible dentro de Article, TechArticle, Product u otro tipo de página justificado, pero sus casillas de verificación no crean elegibilidad adicional de esquema.

Utilice controles nativos <input type="checkbox"> para el estado interactivo y asocie cada control con una <label> mediante envoltura o valores for e id coincidentes. Una pantalla estática que no se puede cambiar no debe hacerse pasar por un control habilitado. Use casillas de verificación deshabilitadas para un ejemplo explícitamente no interactivo, o use una lista con equivalentes de texto como «No marcado» en contextos donde los controles de formulario serían engañosos.

Los usuarios de teclado deben poder acceder a cada casilla habilitada en orden de origen, alternarla con la tecla Espacio y ver un indicador de foco persistente. No mueva el foco después de marcar. Si un mensaje de progreso se actualiza, anuncie un resumen conciso como «Cuatro de seis elementos requeridos completados» a través de una región activa cortés; no anuncie toda la lista nuevamente.

Los estados marcado y no marcado requieren más que color. Preserve la etiqueta cuando esté marcada en lugar de reemplazarla con «Hecho», porque la acción debe seguir siendo identificable. Si el progreso persiste, explique el ámbito de almacenamiento y proporcione Reiniciar progreso. El contenido útil, los indicadores de requerido y la condición de finalización deben permanecer en el HTML renderizado por el servidor cuando JavaScript falle.

Reglas de redacción

Los elementos de la lista de verificación son compactos porque el lector está ejecutando o verificando, no aprendiendo todo el tema dentro del control. Explique la razón en la prosa circundante antes de enunciar la regla.

• Mantenga una lista de verificación de cuatro a diez elementos. Cuatro establece un conjunto finito útil; más de diez se vuelve difícil de escanear e indica múltiples fases.
• Mantenga cada acción en aproximadamente 80 caracteres y de tres a doce palabras. Una etiqueta corta sigue siendo utilizable junto a un control y extraíble sin prosa adyacente.
• Comience con un verbo imperativo específico: Confirme, Abra, Compare, Registre, Pruebe, Adjunte o Verifique. Evite verbos débiles como Considere, Recuerde o Piense en.
• Dé a cada elemento una condición de aprobación. «Verifique el título y los enlaces» puede aprobarse parcialmente, así que divídalo en dos elementos.
• Mantenga los elementos independientes. Si una acción desbloquea la siguiente, convierta el procedimiento en pasos y use la lista de verificación solo para la verificación final.
• Mantenga la gramática y el nivel de detalle paralelos. No mezcle «Confirme la aprobación legal» con «Publique la campaña en todos los canales y supervísela durante una semana».
• Nombre la evidencia cuando la finalización no sea directamente visible: adjunte el informe, registre la marca de tiempo u obtenga el reconocimiento del aprobador.
• Marque los elementos opcionales explícitamente y exclúyalos del progreso requerido. Opcional debe significar que la condición de finalización sigue siendo verdadera sin ellos.
• Use minúsculas con mayúscula inicial y puntuación final de forma consistente. Se prefieren oraciones completas cuando un elemento incluye un calificador.

Nunca ponga estos elementos dentro de un elemento de lista de verificación:

• Varios subpasos ordenados, lógica de solución de problemas ramificada o una segunda lista de verificación anidada.
• Una advertencia de seguridad, exención de responsabilidad legal o consecuencia irreversible que deba verse antes de actuar.
• Un párrafo de explicación, cita larga, testimonio, captura de pantalla, video, formulario o llamada a la acción promocional.
• Una puntuación subjetiva, aspiración abierta, umbral no respaldado o requisito sin evidencia observable.
• Un enlace etiquetado solo como «aquí», porque el elemento debe sobrevivir a la extracción sin contexto circundante.

Tipos de publicación que lo utilizan

Las vinculaciones a continuación están determinadas por el postTypes del frontmatter de esta página. «Requerido» significa que la tarea principal del tipo de publicación depende de un modelo de finalización finito; «recomendado» y «opcional» dependen del tema de la página.

Lista de verificación QA

Contenido y colocación

• El encabezado nombra un objeto, decisión o estado de preparación delimitado.
• La introducción explica qué demuestra completar los elementos requeridos.
• Use de cuatro a diez elementos, dividiendo trabajos más grandes en grupos con nombre.
• Mantenga cada elemento cerca de 80 caracteres y comience con un verbo concreto.
• Cada elemento tiene una condición de aprobación observable y puede verificarse de forma independiente.
• Confirme que reordenar los elementos no interrumpe la tarea.
• El conjunto es finito e incluye todos los puntos de verificación requeridos para su alcance declarado.
• Los elementos opcionales están etiquetados visiblemente y excluidos del progreso requerido.
• Elimine procedimientos anidados, advertencias, explicaciones largas, medios y promociones.

Completo cuando: la colección tiene un propósito delimitado y cada elemento es conciso, independiente y verificable.

Renderizado y accesibilidad

• La condición de finalización aparece directamente después del elemento final.
• Los controles habilitados tienen etiquetas asociadas, operación por teclado y foco visible.
• El estado no se comunica solo por color, iconos, tachado o posición.
• El progreso interactivo funciona sin mover el foco y explica cualquier persistencia.
• Las etiquetas y los criterios de finalización permanecen disponibles sin CSS ni JavaScript.
• Mantenga los datos estructurados en la página contenedora; no invente un esquema Checklist.
• Preserve los mismos campos y orden en los tres mapeos de plataforma.
• Mantenga los comentarios de captura de pantalla como instrucciones; no haga referencia a imágenes faltantes.

Completo cuando: el estado, las etiquetas, el orden y el significado de finalización sobreviven en todas las rutas de renderizado compatibles.

Preguntas frecuentes

La plantilla de academy renderiza las cinco preguntas revisadas en el [[faq]] del frontmatter de esta página. Cubren el número de elementos, la distinción de viñetas y pasos, el estado guardado y los datos estructurados.