Wikis como herramienta de documentación de interfaces de usuario

Un excelente artículo de Peter Gremett en Boxes and Arrows me da la idea de comentar pos aquí lo que puede suponer el uso de wikis como herramienta de creación y soporte de documentación en el proceso de conceptualización y diseño de interfaces de usuario.

Wiki
I am a wiki… Foto de bru76 en Flickr

El artículo se titula precisamente así: Using Wikis to Document UI Specifications. How your design team can benefit from wiki collaboration while avoiding its pitfalls. El autor lo estructura en las siguientes partes:

  • Introducción
  • Descripción del problema
  • Introducción al wiki
  • Beneficios de su uso
  • Problemas y soluciones
  • Conclusiones

Las ideas más interesantes que extraigo del artículo las voy a enumerar tal y como van apareciendo en el texto:

  • El rol del diseñador de interacción es especificar el comportamiento de los elementos de y en la interfaz
  • The Agile Manifesto como elemento que ha ganado en adeptos
  • Como diseñadores, muchas veces nos encontramos en situaciones de trabajo con equipos que utilizan metodologías ágiles
  • El wiki como herramienta de trabajo y soporte de documentación de interfaz de usuario para trabajar en esos entornos ágiles
  • Problemas de los sistemas de documentación no-ágiles:
    • Documentación muy costosa de escribir y de actualizar
    • Fomenta una metodología de trabajo en cascada, donde no hay cabida para la iteración
    • Costosas descargas de la documentación, no favoreciendo la accesibilidad integral de la misma
    • Dificultades para la colaboración entre varias personas dentro de un mismo documento
    • Se confía la responsabilidad a un sólo autor para escribir y actualizar la documentación
  • Utilización de plantillas para generar la documentación en un wiki. Fabricar nuestras propias plantillas para que el proceso de creación de documentos sea más fácil, rápido y sencillo
  • Elementos a considerar en la creación de nuestras propias plantillas:
    • Índice de contenidos
    • Datos del responsable del proyecto
    • Lista de cuestiones a tratar en el documento, sección…
    • Tablas
    • Títulos
    • Subtítulos
    • Referencias
    • Ilustraciones y gráficos
    • Imágenes
  • A medida que vamos reuniendo informaciones e ideas, las podemos incorporar al wiki
  • Este proceso permite que todas las personas del equipo puedan ir revisando los materiales que se incorporan a la documentación
  • A medida que vamos incorporando más contenidos en la documentación, de más calidad y más ricos en matices, los miembros del equipo se ven motivados a hacer lo mismo, y a afinar las revisiones
  • Beneficios de utilizar esta herramienta y metodología:
    • Fomenta la colaboración
    • Aumenta la velocidad de producción de documentación, revisión y consenso
    • Flexibilidad
    • Reversibilidad
    • Se crea un archivo histórico, accesible para nuevos perfiles y personas que se puedan incorporar al proyecto
    • Actualización de imágenes centralizada (si bien como comenta una persona en el post original, los wikis no gestionan la posibilidad de uploads masivos)
    • Proceso de aprobación ligero e informal

¿Comentarios, experiencias, sugerencias?

Comentarios

  1. Daniel,
    yo he hecho algún pinito en la utilización de wikis semánticos (en concreto, XWiki) para documentar proyectos, especialmente la parte de diseño de interfaces.

    Creo que es un campo prometedor, ya que un wiki semántico te permite crear una estructura para los documentos (no una simple plantilla), relaciones entre ellos, etc.

    PD: creo recordar que Balsamiq tiene un plugin para integrar sus prototipos en XWiki; interesante, ¿verdad?

  2. Hola Daniel.
    Qué interesante. Tengo un ejemplo:
    Hay un profesor en la Universidad Católica de Valparaíso, Herbert Spencer(http://www.herbertspencer.net/), que es diseñador de interacción y ha incentivado a sus alumnos en la utilización de wikis para documentar los procesos.
    Les dejo la url por si les interesa verlo: http://tinyurl.com/nkfu45

    Saludos.

  3. Nosotros hemos estado a punto de utilizar una wiki para documentar un nuevo proyecto y al final lo hemos desechado: demasiado grande y demasiada documentación para probar cosas arriesgadas.

    El problema principal, y lo que nos ha echado para atrás, es la integración de imágenes. A la hora de subir los wireframes teníamos que exportarlos a JPG, subirlos desde una página, copiar el nombre, ir a la página donde se iba a meter, hacer el enlace, etc.

    Pero antes o después lo probaremos. Estamos un poco hartos de documentos con cosas como “véase FUNC-WF-USU-ALTA-001″, cuando basta con un enlace.

  4. alguien me puede decir con que roles interactúa el diseñador de Interfaz de Usuario a medida que se desarrolla la interfaz??????????????
    plissssss ayúdenme!!!!!!!!

  5. […] resolución de tareas, debido a que los perfiles UX necesitamos manejar con soltura metodologías y hábitos de documentación de proyectos, que sirvan como elementos de referencia al resto de perfiles integrantes del equipo de […]

Deja tu comentario

*