Hace unos días estaba buscando una información que sabía que había escrito. No recordaba exactamente cuándo, ni tampoco dónde, pero sabía que existía porque recordaba perfectamente haber trabajado sobre ella.
Y al final la encontré.
El problema es que tardé bastante más tiempo del que debería.
Esto me ocurre de vez en cuando, y cuanto más material genero, más ocurre. Tengo documentación de proyectos, explicaciones técnicas, procedimientos, notas, información sobre servidores, cosas que he investigado en algún momento, etcétera. En el momento en el que escribo cada cosa sé perfectamente dónde está y por qué está ahí. Seis meses después ya no necesariamente.
En una empresa creo que esto se multiplica bastante.
Porque además ya no estamos hablando únicamente de lo que recuerda una persona. Una persona averigua cómo se hace algo y lo resuelve. Otra pregunta cómo se hizo. Se lo explica. Unos meses después entra una tercera persona y vuelve a preguntar lo mismo.
Y seguramente todos hemos visto alguna vez una carpeta llamada documentación.
Dentro hay PDFs, Word, hojas de cálculo, quizás algún TXT, varias versiones de algunos documentos y algún fichero que se llama algo parecido a procedimiento_nuevo_final_2.docx.
La información está ahí, sí.
Pero hay una diferencia bastante grande entre guardar información y conseguir que esa información sea útil dentro de dos años.
Por ejemplo, imaginemos que hemos documentado cómo se configura una determinada parte de un servidor. Si dentro de un año necesito esa información, probablemente no recuerde el nombre exacto del documento. Lo que recuerdo es el concepto: SSL, copias de seguridad, Moodle, Apache, o lo que corresponda.
Por lo tanto me interesa poder llegar a la información por lo que significa, y también poder navegar desde una cosa hacia otras relacionadas.
Esto es precisamente lo que siempre me ha gustado del concepto de wiki.
Una wiki permite ir construyendo conocimiento poco a poco. No hace falta sentarse un mes y decir "vamos a documentar toda la empresa", cosa que probablemente no vamos a hacer nunca. Podemos empezar con unas cuantas páginas y añadir información conforme aparece la necesidad.
Hoy documentamos un procedimiento.
Mañana añadimos una página sobre un proyecto.
La semana que viene alguien completa esa página porque ha descubierto una cosa nueva.
Y al cabo de un tiempo tenemos algo que empieza a parecerse bastante a la memoria técnica de la organización.
De ahí sale jocarsa | wiki.
La aplicación permite crear páginas de información, organizarlas y enlazarlas entre sí, de forma que podamos ir construyendo documentación sin depender de una colección de documentos aislados.
A mí me interesa especialmente para documentación técnica, porque en informática tenemos una cantidad enorme de pequeñas soluciones que resolvemos una vez y luego olvidamos.
Un comando concreto.
Una configuración.
Por qué se tomó una determinada decisión en un proyecto.
Qué había que hacer para desplegar una aplicación.
Qué dirección tenía aquel servicio.
Cómo estaba organizada una base de datos.
Son cosas que, cuando estás trabajando con ellas, parece imposible que vayas a olvidarlas. Y luego pasan dos años.
También creo que tiene bastante sentido para empresas que tienen procedimientos internos. Cuando entra una persona nueva, gran parte del aprendizaje consiste en preguntar a las personas que ya están.
Eso está bien, evidentemente, y siempre habrá conocimiento que se transmite mejor hablando. Pero si hay veinte preguntas que todas las personas nuevas hacen, quizás merece la pena escribir las respuestas una vez.
Además, cuando esa respuesta cambia, actualizamos la página.
Y ya está.
No tenemos diez documentos antiguos circulando por diferentes carpetas.
En mi caso cada vez valoro más poder recuperar cosas que hice hace tiempo. Llevo suficientes años trabajando como para que muchas veces mi problema no sea aprender a hacer algo nuevo, sino recordar cómo resolví algo parecido hace cinco años.
Así que jocarsa | wiki va un poco por ahí: ir dejando un rastro útil de lo que sabemos mientras trabajamos.
Porque seguramente dentro de unos meses no recordaremos todo lo que hoy tenemos perfectamente claro.
Y estaría bien que, cuando llegue ese momento, pudiéramos buscarlo en algún sitio.