12.2 - Tecnología Wiki

Para hacer un sitio web (repositorio) lleno de páginas que sean fáciles de actualizar, utilice un Wiki. Un Wiki es un concepto, no un paquete de software concreto. Hay muchos paquetes de software que ofrecen la función Wiki. Está el Wiki original (del hawaiano rápido), luego está DokuWiki, TWiki, KwikiKwiki, PHPWiki, etc. Es una idea tan buena que mucha gente ha escrito sistemas de software que te dan la característica.

Yo ignoraba los Wikis porque pensaba que el nombre era estúpido. Pensé: “Nunca podría usar un sistema con un nombre tan tonto como ese, aunque convirtiera el plomo en oro”. Ni siquiera investigué para saber qué era una Wiki. Tres años más tarde, empecé a utilizar un Wiki que alguien había instalado y lo encontré extremadamente útil para mi productividad. Cómo me arrepiento de haber ignorado los wikis durante tanto tiempo.

¿Qué diablos es un Wiki?

Es un sitio web en el que cualquiera puede editar cualquier página, y enlazar páginas es realmente fácil.

Parece una locura, ¿verdad? Si cualquiera puede editar cualquier página, ¿qué pasa con el vandalismo? Alguien podría venir y borrar cosas, poner información incorrecta en el sistema, etc. Sería un desastre.

Te prometo que hay algunas características que eliminan completamente estos problemas. Primero, consideremos el lado positivo:

  • Es fácil añadir nuevas páginas. Cualquiera puede añadir nuevas páginas. Si un administrador junior es el primero en ocuparse de un nuevo vendedor, puede añadir una página para el vendedor y empezar a enumerar la información de contacto, etc.
  • Los wikis están centralizados y son accesibles. Cualquier persona con un navegador web puede acceder a ellos (teniendo en cuenta los controles de acceso existentes). No se requiere ningún software especial en el cliente.
  • Todo el mundo puede contribuir. Cualquiera puede editar cualquier página cuando vea una errata o tenga información que añadir. Un documento puede empezar como una pequeña lista de comprobación, luego alguien añade elementos y otra persona lo convierte en un documento de proceso completo.
  • Las páginas del wiki se mantienen actualizadas. Cuando cualquiera puede editar cualquier página, se ha resuelto uno de los mayores problemas de la documentación, que es que los documentos suelen quedar desfasados en el momento en que se publican. En cambio, un Wiki es un conjunto de páginas que pueden ser actualizadas inmediatamente por la persona que detecta el material fechado.

El problema de los repositorios de documentos es que suele haber una gran barrera para utilizarlos. Los usuarios tienen que solicitar una cuenta, recibir permiso y acceso, etc.

12.2.1. Notación Wiki y enlace de páginas

Un Wiki reduce la barrera para todos esos temas. No tienes que estar especialmente entrenado para saber cómo usar onelessons en HTML no son necesarios. No necesitas una cuenta para leer los documentos. Si no tienes una cuenta cuando vas a editar un documento, se te da la oportunidad de crear una en ese mismo momento. Las cuentas se crean con permisos predeterminados que permiten a los usuarios realizar la mayoría de las funciones básicas. Y lo mejor de todo es que, aunque los usuarios pueden escribir en HTML puro, también existe la “notación Wiki”, que les permite escribir texto plano que el Wiki formatea. Por ejemplo, los wikis entienden que las palabras rodeadas de asteriscos, guiones bajos y otros símbolos son especiales. Si escribes *así*, se muestra así. Si escribes __como esto__, se muestra como esto. Si haces una lista con viñetas empezando una serie de líneas con *, Wiki transforma esas líneas en una lista con viñetas HTML <ul>. La mayoría de la gente aprende estos códigos muy rápidamente porque ya los usa en el correo electrónico y, si no lo hace, hay abundante ayuda en línea que explica el formato.

Crear enlaces en Wiki también es fácil. Si incluyes una URL, Wiki la convierte en un enlace. Sin embargo, enlazar a otras páginas Wiki es mucho más divertido. Las páginas Wiki tienen nombres en un formato especial llamado WikiWord. Los programadores de Perl lo conocen como CamelCase o StudlyCaps. Es simplemente una sola palabra con mayúsculas mixtas. Por ejemplo, puedes nombrar una página como ListaDeCosasFavoritas. Cada vez que escriba una frase en una página Wiki que incluya ListaDeCosasFavoritas, la Wiki convertirá esa palabra en un enlace a esa página, aunque no haya ninguna página con ese nombre. En ese caso, al hacer clic en ese enlace, el usuario tiene la oportunidad de crear una página con ese nombre. En otras palabras, para crear una nueva página, basta con crear un enlace a ella, hacer clic en ese enlace y empezar a editar.

También es fácil subir documentos a un Wiki. El documento se adjunta a esa página. Por lo tanto, cualquier página puede convertirse en un contenedor de documentos para PDFs, documentos de Microsoft Word, etc. En una ocasión, necesité una forma de almacenar documentos de Microsoft Word para personas sin conocimientos técnicos. Simplemente hice una página Wiki llamada ElNombreDelProyecto y les mostré cómo subir documentos para que los documentos se adjuntaran a esa página. La Wiki muestra automáticamente una tabla con los archivos adjuntos a la página. Si una persona no puede entender la notación Wiki, al menos puede adjuntar documentos a una página. Se crea una división del trabajo: los expertos crean las páginas Wiki y estructuran el repositorio, los menos técnicos adjuntan los documentos a la estructura creada para ellos. A medida que esas personas menos técnicas se sienten cómodas con los conceptos de la Wiki, hacen una transición fácil a las tareas más técnicas.

12.2.2. Prevenir el Vandalismo en la Wiki

Hay controles sociales y características técnicas en los wikis que se combinan para asegurar que los vándalos y los descontentos no destruyan los repositorios.

En primer lugar, los controles sociales son bastante sencillos: cada cambio se registra para la persona que lo ha realizado. Te sorprendería lo eficaz que es esto. Estimo que el 90 por ciento de la razón por la que la gente no va cambiando las cosas a su antojo se debe al hecho de que se registran. Esto es especialmente cierto en un entorno corporativo.

También hay características técnicas que controlan a los vándalos. Todas las páginas Wiki se guardan en un sistema como RCS, CVS, Subversion o Microsoft SourceSafe. Por lo tanto, hay infinidad de cosas que se pueden deshacer. Puedes revertir los cambios fácilmente, o comparar diferentes revisiones de una página para ver exactamente lo que se ha cambiado. Saber que tu vandalismo puede deshacerse fácilmente a menudo le quita la alegría al acto. Si la pintura en aerosol se borrara con la siguiente tormenta, no habría alegría en escribir “Francine ama a Harvey” en una pared.

La mayoría de los wikis tienen sistemas de control de acceso. Cada página o conjunto de páginas puede ser restringido en cuanto a quién puede leer, escribir o renombrar la página. Por defecto, cualquiera puede editar la página, fomentando así “el estilo Wiki”. Sin embargo, quieres que tu página principal, los menús y otras páginas sean editables sólo por personas designadas.

Los puristas de la Wiki afirman que los controles de acceso como éste no son necesarios porque la belleza de la cultura Wiki es que, aunque es fácil para una persona vandalizar una página, es igual de fácil para otra corregirla. Es cierto, pero yo duermo mejor por la noche sabiendo que soy la única persona que puede editar la página en la que aparece el número de teléfono del servicio de asistencia de mi departamento de TI. En la cultura Wiki, “una Wiki con características empresariales” es el código para “una Wiki con control de acceso”.

El golpe de gracia contra la vandalización de la Wiki es la notificación por correo electrónico. La mayoría de los sistemas Wiki pueden enviar notificaciones por correo electrónico cada vez que se modifica una página. El correo electrónico suele incluir lo que se ha cambiado (un informe HTML “diff”) para que puedas ver rápidamente si el cambio fue benigno o perjudicial. Algunos sistemas notifican por defecto al creador original de la página. Algunos sitios configuran un Wiki para que cualquier cambio desencadene una notificación al webmaster. Creo que eso es exagerado.

Aunque documentar “todo” es un buen objetivo, nunca incluyas una contraseña en una página web. Incluso si la página está protegida por una contraseña y en un servidor seguro, eso es buscarse problemas. Por ejemplo, una vez encontré un sitio que supuestamente era seguro porque las contraseñas aparecían en una página a la que sólo se podía acceder a través de una conexión SSL después de introducir la contraseña. Sin embargo, las personas con cuentas shell en la máquina podían entrar y leer el archivo directamente. Como este era el servidor principal del departamento, todo el mundo tenía cuentas.

El sistema Wiki con el que tengo más experiencia se llama TWiki (http://www.twiki.org). Su reclamo a la fama es añadir el control de acceso. Existen otros sistemas, desde los más sencillos (uno está escrito en awk) hasta los más completos. Algunos sistemas más grandes incluyen un Wiki como característica, mientras que algunos sistemas están construidos completamente alrededor del concepto Wiki, como el infinitamente divertido y asombrosamente completo proyecto de enciclopedia de código abierto, Wikipedia (http://www.wikipedia.org).

Volver al índice