Respuesta.

Historia de la pregunta:

El glosario es la base para un lenguaje común de comunicación entre todos los participantes del equipo del proyecto. En proyectos de TI, las interpretaciones erróneas de términos conducen a situaciones conflictivas, errores y devoluciones. En grandes organizaciones, los términos pueden tener diferentes significados para el negocio, los abogados y TI. La introducción y el mantenimiento de un glosario es la respuesta evolutiva del analista a las barreras lingüísticas que surgen.

Problema:

Trabajar sin un glosario centralizado crea un "juego de teléfono descompuesto": palabras comunes se interpretan de manera diferente, se multiplican los significados ocultos y las descripciones técnicas y de negocio se desvían. No hay garantía de que los contratistas y el equipo técnico se entiendan entre sí.

Solución:

El analista de sistemas inicia la creación del glosario al inicio del proyecto, recolectando la terminología de todos los interesados (negocios, TI, contratistas, soporte).
Cada término se documenta con una breve explicación, un ejemplo de uso y la identificación del "propietario" del término.
Se asegura una plataforma de almacenamiento unificada (Confluence, Wiki, portal corporativo) con derechos de visualización/edición para todos los participantes.
Se realizan cambios oportunos en el glosario ante cada actualización de requisitos o aparición de nuevas entidades.
En la documentación y comunicaciones, se agrega siempre un enlace a la definición de cada término de negocios o técnicos.
Se designa a una persona responsable para mantener la relevancia del glosario (ya sea un analista o un "cuidador" designado).

Características clave:

Involucrar a todos los participantes del proyecto en el enriquecimiento del glosario.
Implementación obligatoria de enlaces a términos desde la documentación.
Revisión y moderación constante de términos conflictivos con la participación de negocios y TI.

Preguntas capciosas.

¿Se puede usar un glosario existente de otro proyecto y complementarlo en el proceso?

No. A pesar de la similitud de los términos, incluso palabras idénticas (por ejemplo, "cliente", "pedido") significan fenómenos diferentes en distintos negocios. Copiar definiciones ajenas solo conduce a mayores malentendidos.

A menudo se piensa que el glosario es tarea solo del analista de negocios o lingüista. ¿Es correcto?

No, la participación debe ser de todos (analista de sistemas, desarrollo, pruebas, negocios, implementación), ya que solo el trabajo conjunto garantiza la integridad y claridad de las interpretaciones.

¿Se puede mantener el glosario solo como un documento separado en un disco y no actualizarlo?

No, porque un documento estático se vuelve obsoleto rápidamente, cualquier cambio debe reflejarse de inmediato e integrarse en el flujo de trabajo del proyecto. Los glosarios obsoletos son una fuente de decisiones incorrectas.

Errores típicos y anti-patrones

El glosario se pospone para "después", lo que hace que aviarios o definiciones no formalizadas se cuelen en todos los documentos.
Falta de una persona responsable de llevar el glosario.
Ignorar la necesidad de utilizar hipervínculos a términos en la documentación del proyecto.

Ejemplo de la vida real

Caso negativo

En una gran organización financiera no había un glosario común, el término "pago" se interpretaba de manera diferente en varios departamentos. Esto condujo a la emisión de instrucciones contradictorias y defectos en la versión, reclamaciones de los clientes.

Ventajas:

Ahorro de tiempo al inicio.

Desventajas:

Debates entre equipos, pérdida de tiempo en aclaraciones.
Aumento de incidentes y reelaboraciones.

Caso positivo

En un nuevo producto, se creó un glosario wiki desde el primer día, enriquecido durante el proceso. Los contratistas y el departamento de TI interno actualizaban constantemente sus definiciones, y los términos obsoletos se eliminaban o trasladaban.