Cómo informar de un error en Gaphor

Si alguna vez ha escrito una línea de código, sabrá que todo el software tiene errores. Este será también el caso de Gaphor. Si cree que ha encontrado un error, simplemente haga clic en el siguiente enlace (necesitará tener una cuenta en GitHub) y luego haga clic en el botón verde “New Issue” que se encuentra en la parte superior derecha de la página:

Report a Bug in Gaphor

Cuando cree una incidencia nueva, se le asignará un número y los desarrolladores voluntarios, que escriben y mantienen el código, serán informados por correo electrónico. Podrán anotar preguntas a su cuestión, si las cosas no están claras. Puede que lo cierren inmediatamente y lo marquen como “duplicado” (otra persona ya ha informado del fallo, y harán referencia al problema original). A veces cerrarán el fallo y dirán “no lo arreglarán”, porque no están de acuerdo en que sea un fallo o es demasiado trivial como para invertir tiempo.

Por lo general, hay dos tipos de errores:

  • Técnica: el código tiene un error que hace que el programa se rompa.
  • Comportamiento: el código funciona correctamente, pero está haciendo algo incorrecto.

En ambos casos, para que podamos solucionar el fallo, necesitamos la mayor cantidad de información posible. Cuando cree una incidencia nueva, intente incluir, cuando sea relevante, los siguientes tipos de información:

  • Lo que intentaba hacer,
  • Los pasos que ha dado para conseguirlo,
  • Lo que esperaba que ocurriera,
  • Lo que realmente ocurrió,
  • Por qué esta diferencia es problemática (¡puede que no sea un error!),
  • Detalles técnicos como la versión de Gaphor que está usando, la versión de su sistema operativo y otros aspectos del contexto en el que Gaphor se estaba ejecutando.

Use un lenguaje claro y sencillo para describir el problema y, si es útil, divídalo en pasos para que los desarrolladores puedan recrear fácilmente el problema. Por favor, no dé por sentado que vamos a entender lo que intenta conseguir; sinceramente, es mejor que intente imaginar que nosotros (los desarrolladores) somos un grupo de niños inteligentes de 5 años. Intente explicar todo el problema y no asuma que sabemos lo que quiere decir. ¡No nos importará!

If you would like to get more involved in the development of Gaphor, we’d love to welcome you via the Gaphor developer’s website.