Tiques

Los tiques o incidencias (tickets) del trac sirven para notificar al equipo de desarrollo, defectos encontrados (bugs), mejoras, sugerencias o dudas.

Para generar un tique necesitas estar identificado (login). Una vez identificado podrás usar la opción "New Ticket" en el menú superior.

Descripción

La creación de un tique consiste en completar un formulario formado por los siguientes campos:

Campos obligatorios

• Summary (resumen): es el título del tique y ha de explicar brevemente, en unas pocas palabras, el motivo del tique.

• Reporter (informador): es el nombre de usuario del que genera el tique. Por defecto aparece ya relleno con tu nombre de usuario.

• Description (descripción): es la descripción del tique y allí puedes escribir todas las indicaciones y comentarios que necesites para describir tu incidencia. Nota que allí puedes usar formato wiki.

• Type (tipo): es el tipo de tique. Por defecto está "defect" (defecto o bug) pero hay cuatro opciones:
  • defect (defecto): indica que la incidencia es un problema o un error.
  • enhacement (mejora): sugiere o propone una mejora o un nuevo desarrollo.
  • task (tarea): indica una tarea incompleta o por hacer, como parte de un desarrollo. La creación de este tipo de tiques es más habitual entre los desarrolladores, ya que al planificar un desarrollo es común separarlo en distinta tareas.
  • doubt (duda): indica una duda o la necesidad de una aclaración.

• Priority (prioridad): es la prioridad, urgencia o importancia del tique. Utiliza una escala según la gravedad de la incidencia. Por defecto está "major" que indica una prioridad media. Las opciones son:
  • blocker (bloqueador): indica que el tique es muy grave y está bloqueando el trabajo del usuario.
  • critical (crítico): indica que el tique es grave y ha de resolverse lo antes posible.
  • major (mayor): denota una importancia media-alta. Es la prioridad por defecto y quizá debería ser la más habitual.
  • minor (menor): denota una importancia baja.
  • trivial (trivial): indica poca importancia. Habitualmente se reserva para pequeños detalles que podrían corregirse o mejorarse y que tienen poca envergadura.

• Component (componente): es la parte o componente del desarrollo con la que está relacionado el tique. Por defecto está la opción "General" que es válida tanto para los tiques que no se pueden clasificar en una opción porque no se encuentra o porque pertenece a varias como para indicar que no se sabe asociar a una componente. La componente sirve internamente para completar el campo "assign to" si se dejó en blanco.

Campos opcionales

• Assign to (asignar a): aquí puedes indicar al desarrollador a quien le encargas la resolución del tique. Es el campo owner (propietario) que aparece en la consulta de los tiques. Por defecto aparece en blanco, pero si se deja en blanco se autocompleta con el responsable de la componente en la creación del tique. Ante la duda déjese en blanco.

• Milestone (hito): el milestone o hito es el bloque de desarrollo al que se asocia el tique. Ante la duda debe dejarse en blanco y ya será asignado por el desarrollador que se encargue de resolverlo. Podemos encontrar los siguientes hitos:
  • Development X.X: plan de desarrollo de una versión.
  • Release X.X: plan de liberación de una versión.
  • GUI X.X: plan de desarrollo de la interfaz gráfica (GUI) para una versión.
  • Maintenance: hito sin fecha fin dedicado a tareas de mantenimiento.
  • Future: hito que recoge los tiques que no se están considerando en la etapa de desarrollo actual.

• Version (versión): es la versión de MMS a la que corresponde la incidencia. Puede dejarse en blanco, ya que en algunas ocasiones la incidencia corresponde a varias versiones o a ninguna, por ejemplo si notificamos algo relacionado con la wiki del trac, o relativo a alguno de los paquetes auxiliares de MMS,...

• Keywords (palabras clave): es una lista de palabras clave que pueden ser útiles en la búsqueda o filtrado de tiques.

• Cc (Carbon Copy): es una lista con los nombres de otros usuarios a los que deseas que le lleguen (via email) los cambios o comentarios relativos a dicho tique.

Otros campos

• Due Date: campo de uso interno para indicar la fecha en la que se estima la resolución del tique. No se está usando. Déjese en blanco.
• Actual (hours): campo de uso interno para indicar el tiempo dedicado a la resolución del tique. No se está usando. Déjese en blanco.
• Estimated (hours): campo de uso interno para indicar el tiempo estimado para la resolución del tique. No se está usando. Déjese en blanco.

Consejos

A continuación se indican algunos consejos en la creación de tiques.

Uso de las triples llaves

Encierra todo lo que no es texto en lenguage natural, sobre todo si introduces varias líneas de código, entre triples llaves. Hay dos formas de hacer esto:

En línea

si escribes:

El error aparece al evaluar {{{Real a = a}}}.

obtienes:
El error aparece al evaluar Real a = a.

En párrafo

si escribes:

El error aparece al evaluar el siguiente código:
{{{ 
Real a = 1;
Real a = 2;
}}}

obtienes:
El error aparece al evaluar el siguiente código:

Real a = 1;
Real a = 2;

Creación de enlaces

Puedes hacer referencia en la descripción (o en los comentarios) de un tique a otros tiques, o a alguna parte del trac o incluso a una dirección web externa. Para ello puedes hacer:

• Referencia a un tique. Basta con anteponer una almohadilla al número. Si hago: #369 obtengo #369.

• Referencia a un cambio. Basta con encerrar el número entre corchetes. Si hago: [2435] obtengo [2435].

• Referencia a una página del trac. Puedes hacer el enlace encerrando el nombre de la página entre corchetes y anteponiendo la palabra "wiki". Por ejemplo, el enlace a esta página cuyo nombre es "Tickets" (el nombre es lo que viene trás de: https://trac.localbayes.es/mms/wiki/) sería: [wiki:Tickets] obteniendo: Tickets.

En general, pueden conseguirse otros enlaces mediante el uso de corchetes, una palabra clave, la dirección y opcionalmente un texto alternativo para el enlace, con la forma: [clave:direccion texto alternativo para el enlace]. Para más detalles consulta la documentación sobre enlaces.

Adjuntar archivos grandes

Véanse las indicaciones en el tique ​462: Un espacio común para subir archivos grandes.