En cualquier organización hay procedimientos que todo el mundo acaba aprendiendo. Cómo se prepara una determinada tarea, dónde está un recurso, qué pasos seguimos para publicar algo, cómo se configura una herramienta o qué hacemos cuando ocurre un problema concreto.
Muchas veces esa información se transmite hablando.
Una persona pregunta, otra responde y durante un tiempo el problema queda resuelto. Unos meses después entra alguien nuevo y vuelve a hacer exactamente la misma pregunta.
Yo hago esto también conmigo mismo. Resuelvo una configuración complicada, pasan seis meses y cuando necesito repetirla descubro que recuerdo perfectamente que lo conseguí, pero no exactamente cómo.
Por eso intento escribir cada vez más documentación.
Para información que va creciendo y que varias personas pueden necesitar, una wiki sigue pareciéndome una estructura especialmente cómoda. Cada tema tiene su página, las páginas pueden relacionarse y el contenido se puede ampliar cuando aprendemos algo nuevo.
De ahí sale jocarsa | wiki.
Puedo crear páginas y organizar conocimiento dentro de un espacio compartido. La edición está pensada para ser sencilla porque la principal dificultad de una wiki normalmente no es técnicamente escribir una página, sino conseguir que realmente escribamos la información cuando todavía la tenemos reciente.
También quiero poder buscar. Cuando la documentación empieza a crecer, la jerarquía ayuda, pero muchas veces recuerdo una palabra concreta y prefiero encontrar directamente todas las páginas relacionadas.
En proyectos de software esto me sirve para configuraciones, decisiones técnicas y procedimientos. En formación puede utilizarse para conocimiento compartido, documentación de asignaturas o material que se va construyendo durante el curso.
La ventaja aparece con el tiempo. Una página que hoy me cuesta quince minutos escribir puede ahorrarme volver a investigar el mismo problema dentro de un año. Si además la utiliza otra persona, esos quince minutos empiezan a tener todavía más rendimiento.
jocarsa | wiki está pensada para conservar ese tipo de conocimiento que normalmente existe en la cabeza de alguien hasta que hace falta y esa persona no está disponible.
Cada vez que tengo que resolver por segunda vez una cosa que ya había resuelto antes, me acuerdo de por qué empecé a documentar estas cosas.