Ayuda para rellenar peticiones (bug o feature request) en el tracker de gvSIG
Introducción
Hay dos tipos de peticiones básicas: bug (fallo) y feature request (solicitud de nueva funcionalidad). En este documento nos vamos a centrar el el tipo de petición bug.
Cuando se detecta un bug (fallo) en gvSIG, una vez comprobado que no existe una petición ya abierta sobre el mismo fallo en el tracker [1], se deberá abrir una nueva petición de tipo "bug". Para ello hay que seleccionar "Nueva petición" y rellenar los siguientes campos según la explicación que se aporta.
NOTA 1: las peticiones contienen además otros campos de uso interno para los gestores del proyecto. Por favor rellenar única y exclusivamente los campos que se listan a continuación.
NOTA 2: los campos marcados con un asterisco (*) se deberán rellenar obligatoriamente.
Campos a rellenar
Tipo*
Para el caso de fallos (bugs) se dejará el valor por defecto: "gvSIG bugs".
Tema*
Breve descripción del ticket en una línea. Deberá permitir hacerse una idea del error o sugerencia a reportar, con el mínimo número de palabras posibles.No incluirá numero de versión o build en el que ha sido detectado (actualmente esta información se facilita en otros puntos). Deberá ser conciso e identificar el asunto de forma clara.
Descripción
Descripción lo mas clara posible del problema detectado.Se describirán los pasos que se han realizado y que han dado como resultado el bug. Es importante tener en cuenta que a partir de esta información otra persona debe ser capaz de reproducir el error.
Categoría
Área de la aplicación o funcionalidad relacionada con el fallo detectado.
gvSIG version*
Versión de gvSIG en la que se ha detectado el fallo. Es recomendable comprobar si el fallo se da o no en la última distribución publicada de gvSIG antes de abrir la petición.
gvSIG build
Número de build (distribución). Durante el desarrollo de una versión se publican varias distribuciones. El número de build es un código que identifica a cada distribución de gvSIG y es importante aportarlo al abrir una petición. Puede averiguarse abriendo la ventana "Acerca de..." desde el menú "Ayuda".
Operative System
Se elegirá entre Linux, Windows y Mac.
Keywords
Como información adicional pueden aportarse palabras sobre cualquier tema que guarde relación con el fallo. Su principal utilidad es a la hora de realizar búsquedas.
Has patch
Indica si se aporta o no la solución al problema (modificación del código fuente).
Add-on name
En caso de que el fallo tenga que ver con un complemento concreto, indicarlo.
Add-on version
Versión del complemento indicado en el campo "Add-on name".
Add-on build
Nº de build del complemento indicado en el campo "Add-on name" (consultar en administrador de complementos).
Ficheros
Si se sospecha que los ficheros de datos utilizados en gvSIG tienen que ver con el error es importante adjuntarlos al ticket. Por otro lado a veces una forma sencilla y rápida de explicar el resultado de un error puede ser mediante una o varias capturas de pantalla, que también podemos asociar a la petición. En ambos casos hay que tener en cuenta que el tamaño máximo para archivos adjuntos es de 5MB. Se recomienda comprimir los archivos en formato ZIP, sobre todo en el caso de que se necesite adjuntar más de uno. En el caso de las capturas de pantalla se recomienda utilizar el formato JPG.