Control de calidad/Informes de defectos
TDF LibreOffice en español Document Liberation Project Blogs comunitarios Weblate Nextcloud Redmine Preguntas y respuestas Donar
Me alegro que llegaras aquí. Estas a punto de hacer una aportación importante a LibreOffice. Un buen informe de error es muy útil para nuestros desarrolladores. Mas abajo encontraras alguna ayuda para hacer el proceso mas fácil.
No todos los informes deben ir a Bugzilla
Quizá todos los perros vayan al cielo, pero hay algunos informes de error que deben enviarse a otros sitios diferentes de Bugzilla. Entre los cuales se encuentran:
Clase de defecto | Dónde abrir el informe |
---|---|
Extensiones para LibreOffice | Con el autor de la extensión |
Infraestructura de TDF/LibreOffice (sitios web, listas de correo, etc.) | Redmine |
Compilar LibreOffice | Lista de correo de desarrolladores |
Test unitarios de LibreOffice | Lista de correo de desarrolladores |
Palabras ausentes en los diccionarios | Con el mantenedor del diccionario o repositorio |
Errores en la traducción | Está permitido reportarlas en Bugzilla, pero es más eficiente añadirlos como sugerencias en Weblate (no se requiere registrarse) |
Antes de enviar un informe de error
Confirma que se trata de un error. La mayoría del tiempo, un error es algo que hace que el programa se comporte de una manera que un usuario razonable no quisiera que se comportase. Esto incluye el programa que no hace lo que quieres, haciendo algo que nunca pediste, o simplemente cerrándose de forma abrupta sobre un uso normal. En el trasfondo, un error puede ser algo que causa el programa tardar mas o usar mas recursos que los que deberia.
Confirma que se trata de un error.
- Si necesitas ayuda para usar LibreOffice, deberías leer la documentación. Y si sigues necesitando asistencia, envía tu pregunta a la lista de correo de usuarios de LibreOffice o aPreguntas LibreOffice.
En un momento dado, lo que parecen errores son más bien peticiones de características, en las que sabemos cómo debería funcionar el software en un mundo ideal, aunque la característica que queremos aún no se haya creado. Afortunadamente, no hay que preocuparse tanto por separar los errores de las peticiones de características. Si es algo que interfiere con el uso normal y válido de la aplicación, notifícalo como error.
Sin embargo, es de gran ayuda conocer LibreOffice para tener una idea de lo que es un «uso normal y válido». No querrás pasar mucho tiempo informando de lo que crees que son errores cuando el problema es que aún no sabes cómo usar una determinada característica. Considera leer la documentación de usuario, y usa las aplicaciones mucho para familiarizarte con lo que hacen normalmente.
Si conoce LibreOffice bastante bien y se encuentra con algo que puede ser un error, pero puede ser simplemente algo que no entiende, puede publicar una pregunta en Listas de correo de usuarios de LibreOffice o Ask LibreOffice.
Pero digamos que tu has encontrado algo que realmente parece un error. Esto es lo que hay que hacer después:
- Toma notas para no olvidar nada de lo que estaba ocurriendo en el momento en que apareció el fallo. ¿Qué estabas haciendo, qué esperabas que ocurriera y qué ocurrió en realidad? ¿Cómo supiste que algo iba mal? ¿Puedes reproducir el mal comportamiento?
- Si es posible, compruebe si hay informes de errores similares, existentes (pero evite gastar demasiado en ello, y mejor presentar un duplicado que darse por vencido):
- Vaya a Components, y seleccione el componente (o subcomponente) apropiado.
- Si ha seleccionado un componente: seleccione el subcomponente apropiado, o la Ayuda ampliada si no ve el subcomponente en esa página.
- Si ha seleccionado Ayuda ampliada: seleccione el subcomponente adecuado, o el [1] al final de la lista si no ha encontrado o no conoce el subcomponente adecuado.
- Verá una lista de errores con ese subcomponente. En la parte inferior de la página, seleccione Editar búsqueda. Allí podrá modificar la búsqueda según sus necesidades.
- Si encuentras un informe de error que concierne a tu problema, puedes contribuir a él. Si no encuentra un informe de fallo que concierna a su problema, presente un nuevo informe de fallo.
- Si el error solo sucede en Ubuntu o esta relacionado con la impresión de documentos, ve a #Más_información.
- Después de todo,si no parece haber un informe de error sobre esto, sigue las instrucciones en #Enviar_un_informe.
Enviar un informe
Rellena un formulario diferente para reportar errores diferentes, incluso si los síntomas desde el punto de vista del usuario parecen idénticos, problemas diferentes con diferentes raíces que aparecen en versiones de LibO diferentes podrían ser arregladas por distintas personas, para diferentes versiones, y en momentos distintos. Es imposible seguirle la pista a todo eso en un solo informe de error.
Ve a Bugzilla.
Acceder
Si te pide acceso, entra con tu cuenta Bugzilla.
Si no tiene una cuenta en Bugzilla, créela haciendo clic en New Account.
Componente
En "Componente", selecciona el componente.
Si no estás seguro a que componente afecta tu problema, selecciona el componente Libreoffice. Alguien lo revisara mas tarde y cambiará a un componente mas preciso. (Para más información sobre 'triage, que es revisar errores para enviar los mas importantes al parte superior de la lista, echa un vistazo a "BugTriage".)
Si es un asunto urgente (partes rotas, regresión, etc.), y eres un usuario experimentado que conoce al equipo de desarrollo, puedes asignarlo a uno de los desarrolladores listados en la pagina FindTheExpert
Detalles
Si hay un sección llamada "Sub componente": selecciona el componente en esa sección.
- Si no sabes cual es el componente apropiado, ve a Componentes. En esa página, pincha en el componente apropiado. Lee todas las descripciones de todos los subcomponentes en la página de ese componente. Si no ves un subcomponente apropiado, pincha en Ayuda Extendida, y lee las descripciones de los subcomponentes en esa página.
Selecciona la version de la aplicación en la cual el error ha aparecido. Puedes comprobar la versión en LibreOffice, seleccionando
▸En "Sistema operativo" o "OS", selecciona el sistema operativo.
Si hay una sección de "Hardware", rellenala.
Si hay un sección de "Severidad" y está reportando una solicitud de mejora, seleccione enhancement, en otro caso ignórela a menos que seas un usuario experimentado. Seleccionar "Blocker" no hará que el error sea arreglado más rápido. Si quiere saber las definiciones de los elementos que aparecen en la sección Severidad, mire este esquema.
Puedes ignorar la sección "última versión funcionando bien".
Descripción
Comprueba la tabla "errores posiblemente relacionados" en la página antes de reportar el error y además en Tabla de Duplicados para asegurar que el problema no halla sido ya reportado.
En la sección "Asunto" (también conocida como Resumen):
- No incluir información ya conocida de los campos.
- Incluya los nombres de subcomponentes de Componentes.
- Escriba los subcomponentes en mayúsculas.
- Si los subcomponentes pueden ser confundidos con partes de una palabra (por ejemplo, UI es parte de la palabra huir), rodea el subcomponent con corchetes
- Usa como mucho dos subcomponentes
- Usa subcomponentes exactamente idénticos a los de la lista, pero puedes integrarlos en el asunto como "WIKIHELP [UI] no disponible en todos los idiomas"
- Resume el problema de forma precisa.
- Mal ejemplo: "Archivo roto"
- Mejor ejemplo: "Menu ▸ no disponible (aparece gris)"
- Evita abreviaturas en el Resumen; en su lugar, usa la palabra completa.
- Si el problema escrito en el reporte es que LibreOffice se cierra o no responde ("se cuelga"), añade la palabra CRASH Al resúmen, para que estos errores sean seguidos con mayor facilidad.
Descripción y adjuntos
En la "Descripción larga" o sección "Descripción", da una descripción más larga y explica lo que sucede.
- Enumera los pasos para reproducir el error
- Usa una lista numerada; y
- Explica el método exácto para que pase algo. Por ejemplo, en vez de escribir "Abrir documento", escribe "En una nueva hoja vacía de LibO, en el menú ve a Archivo > Abrir (dialogo de LibO) > tipo de archivo "Documentos de texto" > selecciona el documento de ejemplo adjunto > doble click"
Si estás usando un LibreOffice pre-construido en Linux, di las versiones exáctas de los paquetes de LibreOffice en tu administrador de paquetes. Si estás usando Windows, di el nombre exácto del archivo de instalación, y de donde lo has descargado.
- Incluyendo información a cerca de la localización y el idioma instalado (idioma de la UI, idioma del documento). Podría se útil.
- Incluye si es una versión de 32-bit de LibreOffice en un sistema (Linux) de 64-bit
- Incluye la fuente del paquete si no es la oficial de LibreOffice
Describe el comportamiento esperado y el comportamiento actual.
Puedes incluir un adjunto, como una captura de pantalla o un documento de muestra. La forma mas común de crear una captura es presionando el botón "PrtScn" en tu teclado. Dependiendo del sistema operativo, quizás tengas que abrir una apliacion de edición de imágenes (Como Paint en Windows) y hacer Editar - Pegar en el.
- Si creas capturas de pantalla, cambia el idioma a Inglés antes de hacer la captura. Puedes hacerlo en ▸ ▸ ▸ .
- Puedes hacer las captura más útiles añadiendo comentarios y marcando las areas relevantes con LibreOffice Draw.
- Si quieres añadir más de una captura, reunelas todas en un solo archivo (copía / pega a un documento LibreOffice Draw) y adjunta como un PDF. Por favor añade un pequeño comentario a cada captura para decir que quieres demostrar con ella.
- Si quieres adjuntar más de 1 documento, crea un archivo .zip con todos los documentos y adjunta el .zip.
- Es preferible subir adjuntos individualmente. Sin embargo, si quiere añadir mas de media docena de documentos,crea un archivo .zip conteniendo todos los documentos y añadir ese .zip
- Si lo que intentas adjuntar es demasiado grande para Bugzilla (mayor que 1 MB) puedes usar la Página experimental de subidas.
Estado
La única vez que deberías de cambiar el estado a NEW es, cuando alguien confirma el error en otro lugar (Ask,Lista de correo,algún foro). In esos casos, aporta el enlace a la discusión con la confirmación.
Enviar
Pincha "Enviar", y tu reporte será añadido a la base de datos de Bugzilla.
La interfaz de Bugzilla me intimida
Pista: Si el sistema de seguimiento de errores Bugzilla parece intimidante o demasiado dificil de entender, deberías avisar del problema aquí:
Aunque publiques tu problema en esos canales, tu objetivo debería ser conseguir un buen informe de fallo en bugzilla. Estos canales pueden ayudarle a conseguirlo. Tenga en cuenta que informar de problemas en las redes sociales (Facebook, Twitter, etc.) no es productivo en general, ya que rara vez conduce a un buen informe de error que termine en bugzilla (véase también: 99 ways to ruin an open source project, top 5).
Después de enviar el informe
Si nadie revisa tu reporte en el tiempo apropiado (24 horas para un error crítico, 14 dias para una solicitud de mejora de características), pregunta a alguien para que reproducta tu error en users@global.libreoffice.org mailing list o en el canal IRC #libreoffice IRC://.
Añadir comentarios en los informes
- Porfavor date cuenta de que los comentarios "yo también", no aportan ninguna información adicional.
La excepción a esto en cuando comentas en un informe que no ha sido aun CONFIRMADO. En ese caso, porfavor describe los pasos para reproducir el error (o confirma los pasos dados por la persona que reportó) y cambia el estado a NEW (nuevo). Si los pasos para reproducir el error no están claros, se cambiará el estado rápidamente a NEEDINFO (falta información), por lo tanto encontrar una buena situación y que sea fácil de reproducir es escencial. - Porfavor abstenerse de añadir comentarios del tipo "Tenemos 1000 puestos aquí y solo este error nos impide migrar", ya que no contiene información adicional relevante para la mejora de la calidad ni tampoco aumentará la prioridad.
LibreOffice es OpenSource (código abierto) y tu ayuda reparando problemas relevantes para tu situación en particular es mayormente bienvenida. Puedes hacer:
- Contrata y/o enseña a tus propios desarrolladores a trabajar en LibreOffice - estamos muy felices de enseñarles, mira las páginas de desarrolladores
- Financia a particulares o compañias para que trabajen en asuntos especificos - mira la lista de desarrolladores certificados
- Contacta con The Document Foundation para que te ayude solo si tienes poco presupuesto, y quieres colaborar, coordinar o juntar tus recursos con otros en la misma situación para financiar arreglos especificos o mejoras.
Buenos informes
Requisitos mínimos
- Versión del OS y de LibreOffice;
- Pasos reproducibles enumerados;
- Adjuntos simples cuando sea apropiado;
- Resultados observados/Esperados.
Ejemplos buenos
- tdf#85004 - Writer: Crash when clicking the Reminder icon on the Navigation toolbar
- tdf#87907 - DIALOG: Page preview in print dialog refreshes when opening print details
- tdf#74839 - EDITING: Position of connectors connected to a group aren't updated when editing group content
Ejemplos… menos buenos
Los informes pueden ser menos que ideales por un montón de razones. Abajo se muestran algunos de los problemas más comunes:
Parrafadas de texto
Describir un informe de error en parrafadas de texto es uno de los problemas más comunes. Los desarrolladores no tienen tiempo para leer parrafadas de texto, siempre es mejor un texto claro, sucinto y con pasos enumerados.
Cinco errores en un solo informe
Un informe debería describir sólo un error a la vez. Agrupar errores, o listar una lista de errores con un sólo documento, no ayuda para nada. Para encontrar desarrolladores dispuestos a atacar el problema, es mejor darles un solo tema en que centrarse, es menos probable que escojan un informe con varios errores listados.
Faltan detalles e instrucciones
Todos los informes de error deberían tener como mínimo:
- tu Sistema Operativo y version de LibreOffice;
- pasos claros y reproducibles;
- resultados esperados;
- resultados observados; y
- un adjunto sencillo cuando sea apropiado.
Comentarios superfluos
Añadir un montón de detalles de más es otro problema muy común. Por ejemplo:
- "Esto me bloquea"
- "No puedo usar LibreOffice por culpa de éste error"
- "LibreOffice apesta (o cualquier variación de eso)"
- Una larga lista de razones de porqué bloquea
- Voy a comenzar a usar a tu competidor a menos que lo repares
Archivos adjuntos complejos
Los archivos adjuntos deberían ser tan simples como sea posible, tomate el tiempo de reducir tus ejemplos hasta el mínimo posible. Esto ayuda enormemente a diagnosticar problemas.
Cuando asumen que los colaboradores lo saben todo
No asumas que los colaboradores saben de lo que hablas. Describe tus pasos con claridad y poco a poco.