Documentación de prueba en pruebas de software (ejemplo)

¿Qué es la documentación de prueba?

La documentación de pruebas es una documentación de los artefactos creados antes o durante las pruebas de software. Ayuda al equipo de pruebas a estimar el esfuerzo necesario, monitorizar los recursos y el progreso, y garantizar una cobertura de pruebas adecuada. El registro y los informes de las pruebas constituyen un conjunto completo de documentos que permiten describir y documentar la planificación, el diseño, la ejecución y los resultados de las pruebas.

👉 Inscríbete gratis en el proyecto de pruebas de software en vivo

¿Por qué es necesaria la formalidad en las pruebas?

Para un principiante, es fácil asumir que las pruebas consisten en ejecutar las distintas secciones de código ad hoc y verificar los resultados. Pero en la práctica, las pruebas son una actividad muy formal y se documentan detalladamente. La documentación de pruebas facilita la planificación, revisión y ejecución de las pruebas, además de permitir su verificación.

El grado de formalidad de la prueba depende de:

• El tipo de aplicación bajo prueba (AUT).
• Estándares seguidos por su organización.
• La madurez del proceso de desarrollo.

Las actividades de prueba suelen consumir entre 30 % y 50 % del esfuerzo total de desarrollo de software. La documentación ayuda a identificar mejoras en el proceso de pruebas que pueden aplicarse a proyectos futuros.

¿Cuáles son los tipos de documentación de pruebas?

Estos son los tipos importantes de documentación de prueba:

“En la práctica, estos documentos se crean en diferentes etapas: desde la planificación inicial (política de pruebas, estrategia) hasta la ejecución y el cierre (informes de defectos y resúmenes)”.

Tipos de documentos de prueba	Descripción
Política de prueba	Es un documento de alto nivel que describe los principios, métodos y todos los objetivos de pruebas importantes de la organización.
estrategia de prueba	Un documento de alto nivel que identifica los niveles de prueba (tipos) que se ejecutarán para el proyecto.
Plan de prueba	Un plan de pruebas es un documento de planificación completo que contiene el alcance, el enfoque, los recursos, el cronograma, etc. de las actividades de prueba.
Requerimientos de trazabilidad matriz	Este es un documento que conecta los requisitos con los casos de prueba.
Escenario de prueba	Escenario de prueba es un elemento o evento de un sistema de software que podría verificarse mediante uno o más casos de prueba.
Caso de prueba	Es un conjunto de valores de entrada, precondiciones de ejecución, poscondiciones de ejecución esperadas y resultados. Está diseñado para un escenario de prueba.
Datos de prueba	Los datos de prueba son datos que existen antes de ejecutar una prueba. Se utilizan para ejecutar el caso de prueba.
Informe de defectos	Un informe de defectos es un informe documentado de cualquier falla en un sistema de software que no realiza su función esperada.
Informe de resumen de prueba	El informe de resumen de pruebas es un documento de alto nivel que resume las actividades de pruebas realizadas, así como los resultados de las pruebas.

¿Cuáles son las mejores prácticas para lograr la documentación de pruebas?

En esta sección, aprenderemos sobre las mejores prácticas que ayudan a lograr la documentación de pruebas con ejemplos para ayudarlo a comprenderla mejor:

• Involucre al control de calidad en las primeras etapas del proyecto: Incluya al equipo de control de calidad desde el comienzo del proyecto para que la documentación de pruebas se desarrolle junto con el diseño y los requisitos del producto.
  Ejemplo: QA colabora durante la planificación del sprint para redactar casos de prueba iniciales basados ​​en historias de usuarios.
• Mantenga los documentos actualizados: No se limite a crear documentos de prueba y olvidarse de ellos: actualícelos siempre que cambien los requisitos o las características.
  Ejemplo: Cuando cambia una API de inicio de sesión, actualice inmediatamente los casos de prueba y los resultados relacionados.
• Utilice el control de versiones: Gestione y realice un seguimiento de todos los cambios en los documentos de prueba a través de sistemas de control de versiones para evitar confusiones y pérdida de datos.
  Ejemplo: Almacene los planes de prueba en GitHub para mantener un historial de versiones claro y opciones de reversión.
• Documento para mayor claridad y propósito: Registre únicamente lo que le ayude a usted y a las partes interesadas a comprender el progreso de las pruebas y los resultados.
  Ejemplo: Incluya informes de resumen de pruebas que destaquen los casos de prueba aprobados, fallidos y bloqueados para revisión de la gerencia.
• Utilice plantillas estándar: Siga un formato coherente, como plantillas de Excel o Word, para que la documentación sea más fácil de crear y revisar.
  Ejemplo: Utilice una “Plantilla de caso de prueba” estándar con campos para ID, descripción, condiciones previas y resultados esperados.
• Centralizar el almacenamiento de documentos: Mantenga todos los documentos relacionados con el proyecto en una ubicación accesible para garantizar que los miembros del equipo puedan consultarlos o actualizarlos fácilmente.
  Ejemplo: Almacenar artefactos de prueba en un recurso compartido Google Drive Carpeta accesible para todo el equipo de control de calidad y desarrollo.
• Incluya suficientes detalles: Evite la información vaga o incompleta; la documentación detallada mejora la comprensión y reduce los errores durante la ejecución de las pruebas.
  Ejemplo: En lugar de “Verificar inicio de sesión”, escriba “Verificar que el inicio de sesión del usuario con credenciales válidas se redireccione al panel de control correctamente”.

¿Cuándo se debe crear documentación de pruebas para pruebas de software?

A continuación se presentan algunos de los puntos clave sobre cuándo debe crear documentación de prueba para pruebas de software:

• Fase de planeamiento: Antes de comenzar la ejecución de la prueba, definir claramente el alcance, los objetivos y la estrategia de pruebas.
• Examen de preparación: Durante la planificación de pruebas, establecer plazos, recursos y requisitos ambientales de manera eficiente.
• Análisis de requisitos: Después del análisis de requisitos, garantizar la cobertura completa de las especificaciones funcionales y no funcionales.
• Estandarización del diseño: Antes de diseñar casos de prueba, estandarizar formatos y mantener la trazabilidad en todos los documentos.
• Documentación del escenario: Durante el diseño de pruebas, para documentar escenarios, entradas, resultados esperados y detalles de los datos de prueba.
• Preparación para la ejecución: Antes de la ejecución de la prueba, para verificar la preparación del entorno de prueba, las herramientas y la precisión de la documentación.
• Evaluación posterior: Después de las pruebas, registrar resultados, defectos y lecciones aprendidas para la mejora del proceso.

¿Qué tipos de plantillas se requieren para la documentación de pruebas?

A continuación se muestran algunas de las plantillas que necesita para la documentación de pruebas en las pruebas de software:

Nombre de la plantilla	Herramientas
Plantilla de plan de prueba	Microsoft Word, Google Docs, o Confluence para edición colaborativa y control de versiones
Plantilla de caso de prueba	TestRail, Zephyr (en JIRA), Xray o Excel/Hojas de cálculo de Google para la gestión de pruebas estructuradas
Plantilla de escenario de prueba	JIRA, TestLink o Hojas de cálculo de Google para documentar condiciones de pruebas de alto nivel
Plantilla de Matriz de Trazabilidad de Requisitos (RTM)	Excel, Hojas de cálculo de Google o TestRail para asignar requisitos a casos de prueba
Plantilla de informe de defectos	JIRA, Bugzilla o Azure DevOps para el registro y seguimiento de defectos
Plantilla de informe de resumen de prueba	Confluencia, Google Docs, o TestRail para compilar resultados de pruebas y análisis

Pros y contras de la documentación de pruebas

Ventajas

• La principal razón para crear documentación de pruebas es reducir o eliminar cualquier incertidumbre sobre las actividades de prueba. Esto ayuda a eliminar la ambigüedad que suele surgir al asignar tareas.
• La documentación no sólo ofrece un enfoque sistemático para pruebas de software, pero también actúa como material de capacitación para principiantes en el proceso de pruebas de software.
• Sirve como una buena estrategia de marketing y ventas mostrar la documentación de pruebas para exhibir un proceso de pruebas maduro.
• La documentación de pruebas le ayuda a ofrecer un producto de calidad al cliente dentro de límites de tiempo específicos.
• In Ingeniería de SoftwareLa documentación de pruebas también ayuda a configurar o instalar el programa a través del documento de configuración y los manuales del operador.
• La documentación de pruebas le ayuda a mejorar la transparencia con el cliente.

Desventajas

• El coste de la documentación puede superar su valor ya que requiere mucho tiempo.
• Muchas veces lo escriben personas que no saben escribir bien o que no conocen el material.
• Realizar un seguimiento de los cambios solicitados por el cliente y actualizar los documentos correspondientes resulta agotador.
• Una mala documentación refleja directamente la calidad del producto, ya que puede producirse un malentendido entre el cliente y la organización.

Errores comunes que se deben evitar en la documentación de pruebas

Estos son los errores más comunes que debes evitar en una documentación de pruebas:

1. Evite escribir descripciones de casos de prueba poco claras o ambiguas.
2. No omita la documentación de las condiciones previas y dependencias de las pruebas.
3. Nunca olvides incluir los resultados esperados para cada prueba.
4. Evite el formato inconsistente en diferentes documentos de prueba.
5. No utilice objetivos de prueba vagos o no mensurables.
6. Nunca omita el control de versiones para las actualizaciones de la documentación de prueba.
7. Evite duplicar información en múltiples artefactos de prueba.
8. No descuide la revisión de la documentación para comprobar su exactitud e integridad.

Preguntas Frecuentes (FAQs)