Manual de uso de Trac

Trac es un gestor de proyectos de software. Su meta es “simplificar efectivamente el rastreo y gestión

de problemas de un software, mejoras y progreso en general”.
He usado Trac por bastante tiempo ya, como comentaba desde Bug Tracking System en 2008. Además
prometí en Proyectos, grandes proyectos, que escribiría algo sobre Trac y su uso. Este manual lo tenía
guardado en borradores del blog hace meses, así que puede no incluir todo lo disponible en las últimas
versiones de Trac.
Tal vez esta guía les puede servir para conocer las funcionalidades de Trac, y ayudarlos a convencerse
de si les es útil para su trabajo o no.
A continuación les voy a intentar explicar funcionalidades básicas de Trac y cómo aprovecharlas. En caso
de necesitar más detalles, en cualquier instancia de Trac pueden encontrar la “Guía Trac” (en inglés). La
guía Trac es una documentación auto generada por la instalación del sistema que contiene todos los
apartados necesarios para aprender a usar Trac. Pueden ingresar desde: url-de-trac/wiki/TracGuide.
Wiki – Trac incluye un motor interno de Wiki, usado para textos y documentación en todo el sistema. Se
usa el formato “WikiFormatting”, en las páginas de la wiki, los tickets y mensajes de log. Esto permite
texto con formato y enlaces en todos los módulos de Trac. El objetivo principal es que editar texto sea
sencillo, y alentar a la gente a contribuír y aportar contenido de texto para los proyectos. Pueden
encontrar una guía del formato usado en: url-de-trac/wiki/WikiFormatting
Timeline -Provee una vista histórica de un proyecto en un mismo informe. Lista todos los eventos de Trac
en orden cronológico, una descripción de cada evento, y si aplica, la persona responsable de dicho
cambio. Muestra los siguientes eventos: Creación y cambios de páginas en la Wiki, creación, resolución
de tickets, cambios en el código fuente del repositorio, y etapas completadas. Cada entrada es a su vez
un enlace al evento en cuestión.
Roadmap -El roadmap provee una vista sobre el sistema de tickets, que ayuda a planear y gestionar el
desarrollo a futuro de un proyecto. Incluye la vista principal donde muestra las futuras etapas con los
tickets pendientes y resueltos por etapa con una barra de progreso.
Browse Source – Se usa para navegar por el repositorio de código fuente del proyecto. Permite navegar
por los distintos directorios, y en distintas etapas de desarrollo (ver cómo era el repositorio en un
momento anterior). Al seleccionar un archivo, se nos muestra el contenido. También se puede acceder al
log de revisiones del archivo.
Sistema de Tickets
El sistema de tickets de trac es el elemento central de la gestión, se usa para tareas de proyectos,
pedidos de nuevas características, reportes de errores y asuntos de soporte técnico de software. La idea
en su desarrollo fue hacer de la participación del usuario lo más simple posible.
Básicamente, un ticket se le asigna a una persona que debe resolverlo o reasignarlo a alguien más.
Todos los tickets pueden ser editados, comentados, asignados, priorizados, y discutidos.
Los tickets contienen la siguiente información:

• autor
• type (tipo de ticket – defecto, mejora, tarea)
• component (módulo del proyecto o subsistema al que compete)
• keywords
• priority (prioridad)
• milestone (etapa)
• assigned to/owner (asignado a/dueño)
• cc (otros involucrados)
• resolution (resolución de porqué un ticket fue cerrado)
• status (nuevo, asignado, cerrado, reabierto)
• summary (resumen del problema o tarea)
• description – descripción (debe ser específica, descriptiva y concisa).
Más o menos con eso, pueden ir empezando con Trac. He visto algunas cosas más como la integración
de Eclipse con Mylyn y Trac, que comentaré más adelante. Por cualquier consulta, los invito a postearla
en el Foro de Picando Código.
WIKIPEDIA
Trac es una herramienta para la gestión de proyectos y el seguimiento de
errores escrita en Python, inspirado en CVSTrac. Su nombre original era svntrac,
debido a su fuerte dependencia de Subversion.2 Está desarrollado y mantenido
por Edgewall Software, es software libre y de código abierto.

Hasta mediados de 2005 estaba disponible bajo la Licencia Pública General de GNU,
pero desde su versión 0.9 se distribuye bajo laLicencia BSD modificada.3

Características

 Permite enlazar información entre una base de datos de errores de software,

un sistema de control de versiones y el contenido de unwiki.
 Sirve como interfaz web de un sistema de control de
versiones como Subversion, Git, Mercurial, Bazaar o Darcs.
 Utiliza un sistema de plantillas web propio llamado Genshi.

Enlaces externos

 Sitio web oficial

 Trac Hacks, principal web de complementos para Trac