How to Report Bugs in LibreOffice

From The Document Foundation Wiki
< QA
Jump to: navigation, search
This page is a translated version of the page QA/BugReport and the translation is 18% complete.

Outdated translations are marked like this.
Other languages:
العربية • ‎Deutsch • ‎Ελληνικά • ‎English • ‎español • ‎français • ‎galego • ‎italiano • ‎日本語 • ‎Nederlands • ‎português do Brasil • ‎русский • ‎Türkçe • ‎中文(中国大陆)‎ • ‎中文(简体)‎ • ‎中文(台灣)‎

Glad you made it here. You are about to make an important contribution to LibreOffice. A good bug report is very helpful for our developers. Below, you'll find some guidance to make this process easier.

No todos los informes deben ir a Bugzilla

Quizá todos los perros vayan al cielo⁠Wikipedia logo v3.svg, pero hay algunos informes de error que deben enviarse a otros sitios especializados; entre los cuales se encuentran:

Class of Bugs Where to file the bug
LibreOffice Extensions With the extension author
TDF/LibreOffice Infrastructure (websites, mailing lists, etc.) Redmine
Building LibreOffice Developer mailing list
LibreOffice Unit Tests Developer mailing list

Antes de enviar un informe de error

Confirm that it really is a bug. Most of the time, a bug is something that makes the software behave in a way that a reasonable user would not want it to behave. This includes the software not doing what you want it to do, doing what you never asked it to do, or just plain crashing under normal use. Going behind the scenes, a bug may be something that causes the software to take a lot longer and use a lot more resources doing stuff than it should.

Confirma que se trata de un error.

Comprueba si existen informes de error similares ("duplicados").

  • Ve a Components, y selecciona el componente apropiado (o subcomponente).
  • Si has seleccionado un componente: Seleciona el subcomponente apropiado, o Ayuda Extendida si no puedes ver el subcomponente en esa página.
  • Su has seleccionado ayuda extendida: Seleciona el subcomponente apropiado, o [1] si no has encontrado o no sabes cual es el componente apropiado.
  • Verás una lista de erores con ese subcomponente. En la parte inferior de la página, selecciona "Editar Búsqueda". Ahí, puedes modificar la búsqueda de acuerdo a tus necesidades.

Si encuentras un informe de error que se refiere a tu problema, puedes contribuir en el. Si no encuentras un informe de error que se refiere a tu problema, rellena el formulario para informar del error.

Si el error solo sucede en Ubuntu o esta relacionado con la impresión de documentos, ve a #More Information. Sino, sigue las instrucciones en #Submitting a bug.

But let’s say what you found really does look like a bug. Here’s what to do next:

  1. Take notes so you don’t forget something that was going on around the time the bug appeared. What were you doing, what did you expect to happen, and what actually happened? How did you know something was wrong? Can you reproduce the bad behavior?
  2. Check for similar, existing bug reports:
    1. Go to Components, and select the appropriate component (or subcomponent).
    2. If you selected a component: select the appropriate subcomponent, or Extended Help if you don’t see the subcomponent on that page.
    3. If you selected Extended Help: select the appropriate subcomponent, or the [1] at the bottom of the list if you did not find or do not know the appropriate subcomponent.
    4. You will see a list of bugs with that subcomponent. At the bottom of the page, select Edit Search. There, you can modify the search according to your needs.
    5. If you find a bug report that concerns your problem, you can contribute to it. If you don’t find a bug report that concerns your problem, file a new bug report.
  3. If the bug only occurs on Ubuntu or is related to printing, go to #More Information.
  4. After all that, if it does not look like there is a bug report about this issue, follow the instructions at #Submitting a bug.

Enviar un informe

Nota: Porfavor 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 distiantas personas, para diferentes versiones, y en momentos distintos. Es imposible seguirle la pista a todo eso en un solo informe de error.

File a separate bug report for each bug you run into, even if the symptoms from a user’s point of view seem identical. Different problems with different roots that appeared in different LibO versions might have to be fixed by different people, for different versions, and at different times. It is impossible to track that in a single bug report.

Ve a Bugzilla.

1. Acceder

Si te pide acceso, entra con tu cuenta Bugzilla.

If you are prompted to sign in, log in with your Bugzilla account.

2. Componente

En "Componente", selecciona el componente.

In Component, choose the component.

Si no estás seguro a que componente afecta tu problema, selecciona el componente Libreoffice. Alguien vendra y lo cambiará por ti. (Para más enformación, echa un vistazo a "BugTriage".

Si es un asunto urgente (partes rotas, regresion, etc), los usuarios experimentados pueden asignarlo a uno de los desarrolladores listados en la pagina FindTheExpert.)

3. Detalles

If there is a Sub-component section, select the subcomponent.

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 Help ▸ About LibreOffice

En "Sistema operativo" o "OS", selecciona el sistema operativo.

Si hay una sección de "Hardware", rellenala.

Si hay un sección de "Severidad", ignorala a menos que seas un usuario experimentado. Seleccionar "Blocker" no hará que el error sea arreglado más rápido. Si quieres saber las definiciones de los elementos que aparecen en la sección Severidad, mira este esquema.

Puedes ignorar la sección "última versión funcionando bien".

4. 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.

Check in possibly related Bugs table on the bug-reporting page and additionally in the Duplicates Table to see whether the problem really has not been reported yet.

En la sección "Asunto" (también conocida como Resumen):

  • No incluir información ya conocida de los campos.
  • Incluye los nombres de subcomponentes de Componentes.
    • Escribe 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 al menos dos subcomponentes
    • Usa subcomponentes exactamente idénticos a los de la carta, 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 Archivo ▸ Guardar como 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.
    • If the subcomponent can be confused with parts of a word (for example, UI is part of the word quit), surround the subcomponent with square brackets.
    • Use at most two subcomponents.
    • Use subcomponents exactly as they appear in the list, but you may integrate them into the subject line sentence like “WIKIHELP [UI] not available in all languages”.
  • Summarize the problem fairly precisely.
    • bad example: “File is broken”
    • better example: “Menu File > Save as not available (greyed out)”
  • Avoid short forms like “doesn’t” or “isn’t” to ease queries for strings in the Summary; instead, use the full form, such as “does not” or “is not”.
  • If the problem written in the report is that LibreOffice crashes or stops responding (“hangs”), add the word CRASH to the Summary, so that these bugs can be located and tracked easily.

En la "Descripción larga" o sección "Descripción", da una descripción más larga y explica lo que sucede.

In the Long Description or Description section, give a lengthier, factual description of the problem:

En la "Descripción larga" o sección "Descripción", lista los pasos para reproducir el problema.

  • Usa una lista numerada
  • 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"

En la "Descripción larga" o sección "Descripción": 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

En la "Descripción larga" o sección "Descripción", describe el comportamiento esperado y el comportamiento actual.

Puedes incluir un adjunto, como una captura de pantalla o un documento de muestra.

  • Si creas capturas de pantalla, cambia el idioma a Inglés antes de hacer la captura. Puedes hacerlo en Tools ▸ Options ▸ Language Settings ▸ Languages.
  • 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. Porfavor 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.
  • Si lo que intentas adjuntar es demasiado grande para Bugzilla (mayor que 1 MB) puedes usar la Página experimental de subidas.
  • If you want to attach more than one screenshot, you should collect them all in one document (copy / paste to a LibreOffice Draw document) and attach as a PDF. Please add a short comment to each screenshot to tell what you want to demonstrate with it.
  • If you attach a sample document that exhibits the bug you are reporting, please make the document as minimal as possible. For example, for Writer bugs, the document should ideally have just a single paragraph. To make it easy to find the text from your document in debug tracing, use some very easily recognizable text, like AAAAAAAAAA ₂ ZZZZZZZZZZ for a bug that is triggered by that character.
  • It is preferable to upload attachments individually. However, if you want to attach more than half a dozen documents, create a .zip file containing all documents and attach that .zip.
  • If your attachment is too big to be attached in Bugzilla (bigger than 1 MB) you can use the Experimental upload page.

Status

The only time you should change the status to NEW is, if someone already confirmed the bug elsewhere (Ask, mailing list, some forum). In these cases, provide a link to the discussion with the confirmation.

5. Enviar

Pincha "Enviar", y tu reporte será añadido a la base de datos de Bugzilla.

Click Submit, and your report will be added to the Bugzilla database.

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í:

If the Bugzilla bug tracking system seems daunting or too hard to understand, you should post your problem here:

Even if you post your problem on those channels, your goal should be to get a good bug report on bugzilla. These channels might help you with that. Note, that reporting problems on social media (Facebook, Twitter etc.) is not productive in general as it will rarely lead to a good bug report ending up in bugzilla (see also: 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 connect via webchat.

If nobody has reviewed your report within an appropriate time (24 hours for a critical bug, 14 days for an enhancement request), consider asking someone else to reproduce your bug report on the users@global.libreoffice.org mailing list or IRC channel #libreoffice connect via webchat.

Añadir comentarios en los informes

Hay unas pocas cosas que decir sobre los 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.
  • Avoid posting “me too” comments which contain no additionally useful information.
    The exception to this is when you comment on a bug that has been UNCONFIRMED so far. In that case, please provide reproduction steps (or confirm the ones given by the original reporter) and move the issue to status NEW. Note that if there are no clear reproduction steps, the issue might quickly move back to NEEDINFO, so finding a good and simple reproduction scenario is essential.
  • Refrain from adding comments along the line of “we have 1000 seats here and only this bug prevents us from migrating”, as it contains no additional information relevant to QA or to the priority of the issue.

Notar que LibreOffice es OpenSource (código abierto) y tu ayuda reparando problemas relevantes para tu situación en particular es mayormente bienvenida. Puedes hacer lo siguiente:

    • 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

  1. Versión del OS y de LibreOffice;
  2. Pasos reproducibles enumerados;
  3. Adjuntos simples cuando sea apropiado;
  4. Resultados observados/Esperados.

Minimum requirements

  1. OS/LibreOffice version;
  2. enumerated reproducible steps;
  3. simple attachments where appropriate; and
  4. observed/expected results.

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
  • 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:

Reports can be less than ideal for a number of reasons. Below are some of the common problems:

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.

Describing a bug report in paragraphs of text is one of the most common problems. Developers do not have the time to read paragraphs of text. Clear, succinct, enumerated steps are always better.

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.

One report should only have a single bug in it. Grouping bugs, or listing a whole list of issues with a single document, is utterly unhelpful. In order to find developers to tackle issues, it is best to give them a single issue to focus on. They are unlikely to take on a bug that has multiple issues listed

Faltan detalles e instrucciones

Todos los informes de error deberían tener como mínimo:

All bug reports should have at minimum:

(1) tu Sistema Operativo y version de LibreOffice; (2) pasos claros y reproducibles; (3) resultados esperados; (4) resultados observados; (5) 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:

Adding a lot of extra details that aren’t relevant is another common problem. Examples include:

  1. "Esto me bloquea"
  2. "No puedo usar LibreOffice por culpa de éste error"
  3. "LibreOffice apesta (o cualquier variación de eso)"
  4. Una larga lista de razones de porqué bloquea
  5. 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, toma te el tiempo de reducir tus ejemplos hasta el mínimo posible. Esto ayuda enormemente a diagnosticar problemas.

Attachments should be as simple as possible. Take the time to prune your examples to the bare minimum. This helps tremendously in diagnosing problems.

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.

Do not assume contributors know what you’re talking about. Describe your steps clearly, each step of the way.

Más información