Manual de Calidad de Guadalinex

Esta guía describe los puntos de control y procedimientos necesarios para asegurar la calidad de Guadalinex.

Guadalinex es una distribución de software, esto es, un sistema operativo y un conjunto de librerías, herramientas, programas, aplicaciones y documentación coherentes cuyo funcionamiento conjunto se ha comprobado que es funcional y estable.

La distribución consta de miles de paquetes. Pueden contener software, documentación, o referencias a otros paquetes o a conjuntos de ellos. En este último caso se habla de metapaquetes.

Los paquetes más importantes se seleccionan para formar el CD instalable de Guadalinex. El resto puede instalarse a posteriori utilizando medios como Internet o CDs suplementarios. La mayoría de paquetes no es autosuficiente, sino que requiere de los servicios de otros que son conocidos como sus dependencias; este hecho añade bastante complejidad al proceso de ensamblar una distribución.

Guadalinex se basa en otra distribución -Ubuntu- ya de por sí estable, que a su vez toma los paquetes de Debian.

Para este proyecto es importante trabajar en abierto. Es decir, que cualquiera pueda colaborar y que todo el conocimiento y experiencia que se obtenga durante el desarrollo se comparta libremente. Es por ello que esta guía y los procedimientos que se detallan estén orientados al uso de sistemas informáticos de colaboración que faciliten la publicación en Internet.

El desarrollo de Guadalinex consta de estas etapas:

• Toma de requisitos
• Creación del prototipo alfa
• Test de calidad alfa
• Creación del prototipo beta
• Test de calidad beta
• Creación de la versión candidata a definitiva 1 (Release Candidate)
• Test de calidad RC-1
• Creación de versión RC-n
• Test de calidad RC-n
• Aceptación de RC-n

La toma de requisitos se realiza durante un encuentro colaborativo y abierto en el que los agentes interesados debaten funcionalidades, mejoras y sugerencias que son después destiladas en forma de especificaciones técnicas.

Estas especificaciones reformuladas de forma más llana se convierten posteriormente en el test de calidad. Toda la información sobre el encuentro y sus conclusiones se publica en formato wiki en la Forja de Guadalinex, existiendo un proyecto independiente dentro de la Forja para cada versión de Guadalinex:

* Guadalinex V4: http://forja.guadalinex.org/webs/guadalinexv4/

* Guadalinex V5: http://forja.guadalinex.org/webs/guadalinexv5/

Cada prototipo (alfa, beta, RC…) se publica en Internet y se notifica al Equipo de Control de Calidad (ECC) para que lo dé de alta en el Control de Errores y haga los tests oportunos. Los prototipos se relacionan en la página denominada Pruebas de Calidad dentro de la documentación del proyecto junto a la fecha en que se crea.

El ECC completa entonces los tests, documentando los resultados en la misma página, e indicando en caso de fallo un enlace a la herramienta de gestión de errores Mantis donde seguir la traza al fallo hasta su resolución.

Una vez terminada la batería de tests, el supervisor del proyecto verificará el resultado marcándolo así en la misma página.

La herramienta de control de errores permite al ECC, al Equipo de Desarrollo (ED) y al supervisor del proyecto, seguir la traza a cualquier fallo detectado por cualquiera de los agentes anteriores o por los voluntarios que forman parte de la comunidad de Guadalinex.

Es accesible desde Internet en: http://www.guadalinex.org/errores

En principio, cualquier usuario registrado puede informar de un error. Estos informes pasan por distintos estados:

• Nuevo: cuando el usuario reporta el presunto error
• Se necesitan más datos: si no hay información suficiente para el diagnóstico
• Aceptado: el ECC asume que efectivamente puede ser un error
• Confirmado: si el ECC puede repetir el error en laboratorio
• Asignado: cuando el ED está trabajando en el error
• Resuelto: cuando el error ha sido corregido
• Cerrado:
  • cuando la resolución por parte del ED ha sido confirmada por el ECC
  • o cuando se necesitan más datos y no se recibe respuesta del usuario pasado un tiempo

Cada versión de Guadalinex debe mantenerse durante al menos dos años desde su publicación. A veces se detectan errores a posteriori y otras veces se hacen mejoras para incluir funcionalidades no previstas en el análisis inicial.

Estas correcciones y mejoras pueden provenir de distintas fuentes:

Son los paquetes que la distribución de origen añade y que Guadalinex por tanto debe heredar. Son de estos tipos:

• backports: paquetes de una versión más moderna que se adaptan para funcionar en versiones anteriores
• security: paquetes que solucionan fallos de seguridad
• updates: mejoras de paquetes de la distribución

Semanalmente, los lunes, el ECC comprobará el mirror del repositorio de paquetes de la distribución base en los servidores de Guadalinex. Dicho servidor se sincronizará semanalmente los domingos con la distro base. Si existen paquetes nuevos, intentará integrarlos en la distribución de Guadalinex verificando que no hay ningún conflicto. Se informará a la dirección del proyecto de los resultados de las pruebas como muy tarde el miércoles, vía e-mail y actualizando la página del wiki.

En función de estos resultados, la dirección del proyecto actualizará los repositorios de Guadalinex.

Cada paquete creado por el ED se publicará en el repositorio de test, y se notificará por e-mail al ECC.

El ECC comprobará su validez y reportará meidante el wiki de calidad el resultado de las pruebas.

En caso positivo el paquete pasará al repositorio estable.

Con los paquetes de terceros se actuará de igual forma que con los propios, con la salvedad de que cualquier fallo se reportará a la empresa/entidad o particular responsable del desarrollo.

La documentación técnica y de usuario generada por el ED será remitida al ECC para su revisión. El ECC emitirá un informe positivo o una lista de erratas que el ED deberá subsanar.

La página web de Guadalinex se compone de varias aplicaciones:

• Web principal, donde se publican noticias y se reune la comunidad de usuarios.
• Teleformación, para aprender sobre Guadalinex y sus aplicaciones
• Guadapedia, compendio de documentación de Guadalinex
• Forja, para el desarrollo de proyectos de software libre

Será cometido del equipo de calidad la supervisión de estos sitios, comprobando:

• Idoneidad de los contenidos, obsolescencia.
• Enlaces perdidos
• Fallos de accesibilidad (nivel AA).
• Presencia de direcciones de e-mail aprovechables por los rastreadores que usan los SPAMMers.

Los informes de auditoría se enviarán trimestralmente en un formato de documento estándar (ISO/IEC 26300, ODF) al responsable para su subsanación.

En casos excepcionales se informará de inmediato de errores graves que puedan afectar a la imagen del proyecto o a su funcionamiento.