Así es Feedback: informes de bugs y solicitud de características

Feedback es la aplicación que Xojo pone a nuestra disposición para facilitarnos tanto el envío como el posterior seguimiento de los informes sobre los bug detectados en los diversos componentes, como pueda ser el IDE o los frameworks, así como para la solicitud de nuevas características. A continuación encontrarás, traducido al español, el artículo publicado originalmente por Xojo en inglés y que se puede consultar desde este enlace.

Si crees haber encontrado un bug en Xojo o tienes que hacer una solicitud de nueva característica, entonces lo mejor que puedes hacer es informar a Xojo sobre ello. El modo de informar sobre bugs o solicitar nuevas características es mediante la aplicación Feedback. Se ha diseñado la aplicación Feedback de modo que reuna toda la información necesaria para que nos permita hallar los bugs indicados y también implementar las características indicadas.

Por cada uno de los informes sobre bugs o bien solicitud de nueva característica (que denominaremos caso), recibirás un mensaje de confirmación vía email con el número de caso. Cada vez que se actualiza un caso, obtendrás el correspondiente email informando sobre el cambio.

Puedes ejecutar la aplicación Feedback directamente desde el IDE de Xojo. Sólo has de seleccionar la opción de menú Help ↠ Xojo Feedback o bien hacer clic sobre el botón Feedback en la barra de herramientas. Si ya tienes instalada la aplicación Feedback en tu ordenador, entonces dicha acción abrirá la aplicación en cuestión. Si aun no tienes instalada Feedback, entonces tu navegador web por omisión abrirá la página web de descargas de Xojo, desde donde puedes descargar la app para tu sistema operativo.

Como usar la aplicación Feedback

La aplicación Feedback tiene tres áreas principales: el campo de búsqueda, la barra lateral y el área de caso.

Buscar y crear nuevos Casos

Para poder crear un nuevo caso tendrás que realizar una búsqueda previamente.

El campo de búsqueda es donde buscarás los casos. Has de buscar por el caso antes de que puedas crear uno nuevo. Esto permite que se puedan hallar casos idénticos o similares ya existentes sobre el mismo tema, de modo que se evite duplicarlos. Si quieres crear un nuevo caso, sólo has de introducir el título para el caso como criterio de búsqueda, de modo que puedas ver un listado de casos similares.

Tras la búsqueda, tendrás la capacidad de guardarla (en la sección Folders de la barra lateral) o bien crear un nuevo caso. También puedes hacer simplemente doble clic sobre cualquier caso disponible de entre los resultados para verlo.

Consejos de búsqueda

• Cuando se realiza una búsqueda, siempre se utiliza “AND” de forma implícita entre las palabras clave
• PUedes utilizar el caracter “-” para excluir palabras concretas de la búsqueda: toolbar -linux
• El caracter “|” se utiliza como significado de “OR”: Str | StrB
• Puedes utilizar paréntesis para agrupar elementos: listbox -(hierarchical | checkbox)
• Utiliza comillas para buscar frases literales: “windows build”
• El índice omite palabras comunes y abrevia los sufijos comunes

Detalles de Caso

Cuando se crea un nuevo caso sob varios los campos que precisan la introducción de información:

• Sumary: Incluye un resumen descriptivo. No podrás guardar el caso salvo que se haya introducido un resumen descriptivo de longitud suficiente.
• Product: Selecciona el proyecto para el cual se aplica, por lo general sólo tendrás que seleccionar “Xojo”.
• Case Type: Puede ser Bug, Beta Bug o Feature Request.
• OS: Selecciona el sistema operativo utilizado en el que se ha advertido el problema.
• Steps to Reproduce: Incluye pasos detallados sobre como reproducir el problema. Es más probable solucionar los casos que incluyen pasos reproducibles. Ver más adelante sobre consejos de formato.
• Expected Result: El resultado que esperabas obtener.
• Actual Result: El resultado obtenido.
• Workarounds: Cualquier atajo para el problema encontrado.
• Attachments: Incluye cualquier cantidad de adjuntos, preferiblemente proyectos de ejemplo, si bien también pueden resultar de utilidad las capturas de pantalla y los vídeos.
• Visible to: Elige quien puede ver tu caso de Feedback. Por omisión es “Everyone” (todos), pero si tienes información privada en el caso, entonces puedes elegir la opción “Only me and Xojo” (sólo yo y Xojo). En los casos Beta, selecciona la visibilidad Beta.

Añadir información

Puedes añadir información adicional a cualquier caso, incluso aquellos que no hayas creado tu. Para ello, haz clic sobre el icono de “lápiz” en la barra de herramientas de la parte inferior para abrir una nueva área de Detalle de Caso, donde podrás introducir texto adicional, adjuntos e indicar su visibilidad.

Para añadir información privada a un caso (incluyendo un proyecto privado), crea el caso tal y como harías normalmente y elige a continuación el icono de “lápiz” para añadir información adicional al caso al tiempo que defines la visibilidad a “Only me and Xojo” (sólo yo y Xojo).

Barra Lateral

Mis Informes

La sección My Feedback Esta sección del navegador te prorporciona un vistazo rápido de casos que son relevantes para ti.

• Dashboard: El Dashboard the proporciona un vistazo de tus casos y su clasificación.
• My Top Cases: Utiliza esta pantalla para calificar tus casos. Los usuarios licenciados de Xojo tienen sus casos con una mayor calificación. Arrastra los casos abiertos desde la barra lateral a la posición apropiada para recalificar un caso.
• My Favorites: Estos son los casos que has creado o casos que has marcado como favorito haciendo clic en el botón de “estrella” disponible en la barra de acción del caso.
• Participating in: Estos son los casos que has creado y aquellos en los que hayas incorporado tus comentarios.

Informes Compartidos

La sección Shared Feedback incluye la siguiente información:

• Search Results: Los resultados correspondientes a las búsquedas más recientes.
• Top Cases: Muestra los casos mejor calificados, basándose para ello en las calificaciones de todos.
• Release Notes: Muestra las notas de revisión de Xojo.

Carpetas

Puedes crear tus propias carpetas y añadir casos en ellas, lo cual puede resultar útil para su seguiminto. Utiliza la barra de acción situada bajo la barra lateral para añadir una nueva carpeta. Puedes arrastrar casos abiertos desde la barra lateral a una carpeta para un acceso rápido.

Las carpetas pueden ser locales o compartidas. Si creas una carpeta compartida entonces tendrás la opción de proporcionar una contraseña. Haz clic derecho sobre una carpeta compartida para obtener su “enlace compartido” y enviarlo a aquellos que quieras permitir el acceso a la carpeta.

También aparecerá en la sección Folders los resultados de las búsquedas que hayas elegido guardar.

Área de Caso

El área de caso puede mostrar información sobre un caso o casos. También puedes hacer clic en el Dashboard en la barra lateral para mostrar una vista previa de los casos creados o calificados.

Cuando se muestra una lista de casos, como por ejemplo en los resultados de una búsqueda, puedes personalizar las columnas visibles usando para ello la característica View ↠ Customize List Columns. Puedes hacer clic en cualquiera de las cabeceras para ordenar el listado. Si quieres que aparezca un avatar junto con tu nombre en los casos y comentarios, crea una cuenta de Gravatar y asóciala con el email utilizado en tu cuenta de Xojo.

Cuando se examina un caso, puedes ver su título original y descripción, junto con las notas añadidas al caso. También podrás ver el estado general del caso.

Formateado

En la descripción del caso, puedes formatear snippets de código utilizando el tag [code]:

[code]

Dim i As Integer

i = 10

[/code]

Estado del Caso

El estado del caso cambiará a medida que avanza el caso a través del sistema. Este es un listado de los estados y lo que pueden significar:

• Needs Review: El caso está en la cola para su revisión.
• Reviewed: La característic/o bug ha sido revisada y está pendiente de decisión.
• Verified: Se ha verificado el caso y se ha asignado a un ingeniero.
• Scheduled: Se ha progrmado el caso para desarrollo.
• Fixed: Se ha comprobado una solución para este caso y está pendiente de verificación.
• Implemented: Se ha completado la característica, se ha incorporado y está pendiente su verificación.
• Implemented and Verified: Se ha verificado la característica y está disponible en la versiónd el IDE indicada.
• Closed: Se ha cerrado el caso por la razón indicada.
• Information Required: El caso está esperando por información adicional po parte de su autor.

Calificar los casos

Utiliza la opción My Top Cases de la barra lateral para calificar los casos. Arrastra los casos abiertos desde la barra lateral sobre cualquiera de las áreas de clasificación para calificar el caso. Puedes calificar hasta un total de 5 casos. La clasificación funciona así:

• Cada licencia activa que tengas de Xojo contará como 1 punto
• Una licencia Xojo Pro cuenta por un total de 12 puntos (4 puntos por cada licencia multiplicado por 3)
• Asignar un caso a una posición superior multiplica tus puntos. Si tienes sólo una licencia, entonces la quinta posición de un caso proporciona 1 punto. Una primera posición para un caso proporciona 5 puntos.

Bajo cada posición del ránking verás la cantidad de puntos aplicados a los casos.

Crear buenos casos de Feedback

Es fácil crear casos en Feedback, pero no es tan fácil crear buenos casos. Estos son los tipos de casos que puedes crear: Beta Bug, Bug y solicitud de característica.

• Beta Bug: Un bug encontrado en la beta actual de Xojo.
• Bug: Un bug que se ha encontrado en la actual versión disponibe de Xojo.
• Feature Request: Un cambio o sugerencia para incorporar nueva funcionalidad.

¿Qué hace que un caso sea bueno? Un buen caso es un caso que está bien definido, con pasos reproducibles y generalmente un proyecto asociado que demuestre el problema.

Empieza con un buen resumen. Feedback utiliza búsqueda fonética inteligente sobre el resumen de cada caso. No busca los detalles del caso. Un buen resumen de caso debería ser lo suficientemente escueto y describiendo de la mejor forma posible el caso.

Un ejemplo de un buen resumen de caso es: “HTMLViewer should use WebKit on all platforms”. Resúmenes como “HTMLViewer doesn’t work” o “WebKit” no son informativos, demasiado cortos y no específicos, haciendo que resulten difíciles de encontrar durante las búsquedas.

En el caso de los bugs, los detalles deberían de describir el problema con claridad e incluir los pasos que permitan reproducirlo. Idealmente también querrás adjuntar un proyecto de ejemplo que demuestre el problema. Nuestras estadísticas muestran que los casos con proyectos de ejemplo se solucionan con mayor prontitud en comparación con los casos que no incluyen proyecto. Si se crea un caso que no se puede reproducir, entonces su estado puede cambiar a “Closed” (cerrado) o “Information Required” (Información requerida). En ambas situaciones, querrás proporcionar información adicional si quieres que el caso permanezca abierto.

Para la solicitud de características, los detalles deberían de describir el problema que se intenta solucionar. Intenta evitar las sugerencias sobre detalles de implementación.

Publicar enlaces de Feedback en el Foro

En ocasiones resulta de utilidad publicar enlaces a tus casos de Feedback, de modo que otros puedan verlos y marcarlos como favoritos o bien añadir más información. Para ello, haz clic en el icono con forma de rueda dentada de la parte inferior del caso de Feedback y elige la opción “Copy Sharing Link” en el menú. A continuación puedes pegar este enlace en tu entrada del foro (no utilices formateado adicional) y este aparecerá automáticamente en tu entrada como un enlace que abrirá Feedback y mostrará el caso.

Resolución de problemas

Si estás teniendo problemas en el acceso a Feedback, estas son algunas de las cosas que puedes comprobar:

• Descarga e instala la última versión.
• Verifica que has introducido correctamente la información de tu cuenta Xojo.
• Si estás usando un Proxy, asegúrate de haber introducido la información del proxy.