056.3 Lección 1

La comunicación sincrónica es una forma de comunicación muy eficaz, pero también muy exigente. Reúne a personas al mismo tiempo en el mismo espacio físico o virtual.

Una reunión directa es ideal para hablar de las cosas de forma interactiva en lugar de enviar mensajes de correo electrónico largos que conllevan el riesgo de malentendidos. Imagina que quieres aprender más sobre un proyecto de código abierto y conocer a la gente de la comunidad. Los mensajes de correo electrónico y los sitios web pueden ayudar a hacer una presentación y tener una barrera de entrada más baja, pero una primera impresión verdaderamente significativa se produce cuando realmente puedes hablar con alguien en persona; son estas interacciones directas las que generalmente fascinan a las personas sobre un proyecto de código abierto y las hacen querer contribuir.

Además de conocerse mejor, las reuniones sincrónicas también son excelentes para hablar de las cosas de forma interactiva, por ejemplo, en caso de conflictos o problemas, o cuando hay que compartir un mensaje negativo.

La desventaja es que los proyectos internacionales enfrentan un desafío que la tecnología no puede superar: las zonas horarias. Si tienes colaboradores en diferentes continentes, será muy difícil encontrar horarios de reunión adecuados para todos. Es posible que alguien en Australia se esté despertando cuando alguien en Europa está a punto de terminar su día. Como desafío adicional, algunas personas pueden trabajar solo por la noche o los fines de semana, mientras que otras prefieren el horario de oficina durante los días hábiles.

Además, el inglés no es un idioma que todos hablen con fluidez y aún no existen herramientas de traducción en vivo ampliamente accesibles, lo que supone una barrera adicional.

Aun así, las videoconferencias son una de las herramientas de comunicación más frecuentes en los proyectos de código abierto. El proyecto LibreOffice, que sirve de ejemplo para esta lección, tiene reuniones online periódicas para su comunidad, por ejemplo, para desarrolladores, marketing, infraestructura, control de calidad, experiencia de usuario y diseño.

La comunicación asincrónica te permite participar en la conversación en el momento y a la velocidad que te resulte más conveniente. El ejemplo más conocido es probablemente un mensaje de correo electrónico: puedes responder a un mensaje cuando lo prefieras, ya sea al minuto, al día o a la hora siguiente.

En el caso de la comunicación asincrónica, el contenido suele estar escrito, lo que además abre la posibilidad de la traducción automática. Esto te ayuda a leer y comprender mensajes escritos en un idioma diferente al tuyo, e incluso puedes traducir tu respuesta.

Además, el contenido que ya está escrito facilita mucho la retención de conocimientos y la producción de documentación. Imagina que quieres escribir un documento de soporte sobre cómo utilizar una función específica de un software. Si se lo explicas a un usuario por teléfono, será mucho más difícil convertir tu discurso en una página de documentación adecuada que si explicas el procedimiento en texto escrito.

Por último, pero no por ello menos importante, la comunicación también depende de los destinatarios previstos, es decir, si es interna o externa. La forma de escribir una nota técnica interna para los administradores del sistema es diferente a la de escribir un comunicado de prensa que se envía a cientos de periodistas. Sin embargo, tenga en cuenta que, debido a la naturaleza de un proyecto de código abierto, la comunicación que no esté explícitamente destinada a un público objetivo será visible públicamente, por ejemplo, en los archivos de listas de correo (en el caso de LibreOffice, es https://listarchives.documentfoundation.org/).

Una de las primeras herramientas con las que te encontrarás cuando participes en un proyecto de código abierto es el correo electrónico “clásico”. Muchos proyectos utilizan listas de correo, que son básicamente listas de distribución de correo electrónico: con un mensaje de correo electrónico, puedes llegar a cientos o incluso miles de suscriptores que están interesados en temas específicos.

Las listas de correo se encuentran entre las herramientas más antiguas que se conocen en cualquier proyecto de código abierto y se utilizan para la coordinación interna del proyecto, así como para interactuar con los usuarios. Si tiene una pregunta sobre el software o desea informar un error en el programa, es muy probable que exista una lista de correo que le permita hacerlo. La comunidad de LibreOffice, por ejemplo, ofrece una variedad de listas de correo internacionales y locales para varios temas (https://www.libreoffice.org/get-help/mailing-lists/), que van desde soporte al usuario hasta discusiones con desarrolladores y coordinación de infraestructura (<<lo_mailinglists> >).

Página web de listas de correo de LibreOffice image::./images/lo_mailinglists.png[width="75%",id="lo_mailinglists"] Cada mensaje enviado se suele almacenar en un archivo de listas de correo públicas para futuras referencias. Una vez enviado, un mensaje no se puede borrar fácilmente. Una frase común dice: “Internet nunca olvida”. Por lo tanto, es recomendable tener cuidado con lo que escribes, porque probablemente no puedas retractarte. Por ejemplo, algunas personas tienen su dirección privada o número de teléfono en la firma, o envían documentos confidenciales como archivos adjuntos, lo cual debes evitar cuidadosamente.

Una desventaja de las listas de correo es que su gestión en el programa de correo no siempre es sencilla. Es posible que desee crear los llamados filtros basados en elementos específicos del mensaje, por ejemplo, un prefijo en la línea de asunto. Las sutilezas de la gestión de grandes cantidades de correo electrónico pueden ser una barrera para los usuarios inexpertos, especialmente si su mensaje es único. Por lo tanto, cada vez más proyectos migran a foros de discusión, sobre los que pronto aprenderá.

Una forma especial de lista de correo es un boletín informativo. Si desea mantenerse al día sobre los últimos avances del proyecto y recibir información sobre nuevos lanzamientos de software, puede suscribirse al boletín informativo y recibir un mensaje de correo electrónico cuando ocurra algo importante.

Aparte de la sobrecarga que supone gestionar listas de correo en tu cliente de correo electrónico, otra desventaja del correo electrónico es que cada vez más gente, especialmente la generación más joven, ya no se comunica tanto por correo electrónico. Por esta y otras razones, cada vez más proyectos de código abierto trasladan su comunicación a foros de discusión. La idea general es muy similar a la del correo electrónico: cada foro tiene varias categorías con temas específicos para debatir, los llamados hilos. De forma similar al correo electrónico, en un foro puedes ponerte en contacto con el proyecto de código abierto y coordinar actividades, hacer sugerencias sobre la dirección del proyecto e informar de errores como usuario final.

Todo lo que se publica en un foro suele ser visible para el público en general, al igual que en una lista de correo; pero a diferencia de lo que ocurre en este último caso, dependiendo de la configuración del foro, los contenidos también se pueden editar o eliminar más tarde. La usabilidad de los foros es, especialmente para los usuarios inexpertos, a menudo mejor que la de las listas de correo. El proyecto LibreOffice comenzó a convertir varias de sus listas de correo en foros (https://community.documentfoundation.org/) y desde entonces ha visto un aumento en la participación en la discusión.

Página web de foros de LibreOffice image::./images/lo_forums.png[width="75%",id="lo_forums"]

Otra forma de ponerse en contacto con una comunidad abierta es a través de mensajes instantáneos y plataformas de chat. Con el auge de herramientas populares como WhatsApp, Telegram, Signal y Matrix, casi todo el mundo ya ha instalado una de estas aplicaciones populares en sus dispositivos, lo que hace que la barrera de entrada sea mucho menor. Los mensajes instantáneos también son mucho más populares entre las generaciones más jóvenes que el correo electrónico o los foros. Por lo tanto, no es de extrañar que muchos proyectos de código abierto los adopten en la actualidad.

Los participantes de un chat escriben mensajes que se envían a todos los demás participantes, de forma similar al correo electrónico. Según la plataforma de chat, un mensaje puede enriquecerse con formato, gráficos y archivos adjuntos.

En términos estructurales, las aplicaciones de mensajería están organizadas de manera similar a un foro o correo electrónico. Hay varios grupos o canales disponibles, por lo que puedes participar en debates sobre temas que te interesen. Los mensajes generalmente se pueden editar o eliminar y, a menudo, también hay canales exclusivos de anuncios que tienen una función similar a los boletines informativos por correo electrónico.

Una desventaja de las aplicaciones de mensajería instantánea es que la gente suele instalarlas en sus teléfonos, por lo que reciben notificaciones de cada mensaje enviado. Esto puede convertirse rápidamente en un exceso de información o en una “fatiga de alertas”. Sin embargo, con una configuración adecuada, estas notificaciones se pueden mantener bajo control.

Otra desventaja es que muchas aplicaciones de mensajería son propietarias y están en manos de un solo proveedor. Esto hace que preservar la información a largo plazo sea más complicado si los datos no son de libre acceso.

Los proyectos de código abierto funcionan de forma abierta, basándose en estándares y herramientas abiertos. Por lo tanto, es fundamental comprender cómo se diseñan las distintas herramientas en relación con la interoperabilidad. Las opciones se pueden dividir en tres categorías principales.

Una plataforma autónoma funciona de manera aislada para una comunidad. Algunos ejemplos son los foros o wikis, que normalmente no están conectados con instancias de otros proyectos.

Los sistemas descentralizados o federados funcionan de forma individual para cada comunidad, pero pueden conectarse entre sí. Un ejemplo es el correo electrónico, ya que un servidor de correo electrónico local puede enviar correos a cualquier otro servidor de correo del mundo. Otros ejemplos son Nextcloud y ownCloud, que pueden “federar” archivos compartidos con otros servidores, y el servicio de mensajería Element, con el que se puede comunicar con usuarios de otros servidores. Los mismos principios se aplican a la red social Mastodon.

Tanto las plataformas independientes como las distribuidas tienen una gran ventaja: el proyecto de código abierto conserva el control total sobre todo el contenido y la funcionalidad. Todo el conocimiento almacenado en un sistema de este tipo sigue siendo propiedad de la comunidad de código abierto y no está sujeto a terceros.

Por otro lado, un sistema centralizado es administrado por un proveedor y no interactúa con terceros. Los ejemplos clásicos son las redes sociales como Facebook o Instagram, o incluso las aplicaciones de mensajería como WhatsApp o Telegram. Todo el contenido se almacena en los servidores del proveedor externo y está sujeto a sus términos y condiciones.

Si participa activamente en una comunidad de código abierto, es probable que se ponga en contacto con ellos mediante estas tres opciones. Los sistemas centralizados son excelentes para llegar a la gente, ya que suelen ser populares y tienen una gran base de usuarios. Sin embargo, para el trabajo real en el proyecto, lo mejor es un sistema federado o independiente bajo el control de la comunidad.

Una de las herramientas de colaboración más antiguas y populares es la wiki. Wikipedia se hizo famosa porque permite a los usuarios trabajar juntos en un sitio web que está compuesto por varios documentos o “artículos”. Se pueden agrupar en varias categorías, filtrar por idioma y contener formatos, hojas de cálculo e imágenes.

Las wikis se utilizan a menudo como una base de conocimiento en la que todo el mundo puede contribuir. Si quieres contribuir con contenido a un proyecto de código abierto, participar en su wiki es una de las formas más sencillas. Puedes tomar contenido existente y traducirlo a tu lengua materna, editar y actualizar artículos existentes o crear contenido nuevo. En la wiki del proyecto LibreOffice (https://wiki.documentfoundation.org), puedes encontrar material de marketing, actas de reuniones de la junta directiva, instrucciones de instalación y planificación de conferencias, todo ello en una variedad de idiomas (<<lo_wiki> >).

Muchos proyectos de código abierto también alojan su documentación y el sistema de ayuda integrado de sus programas en una wiki. Además, las versiones antiguas de una página (denominadas revisiones) se archivan para futuras referencias.

Aunque las wikis también pueden almacenar archivos de proyecto, existen mejores herramientas para este propósito, como aprenderá en esta lección.

Otra herramienta que se utiliza con frecuencia en un proyecto de código abierto son los bug trackers, también llamados issue trackers. Si descubre un problema en el software o desea sugerir una nueva función, puede pensar en enviar un mensaje de correo electrónico al respecto. Sin embargo, con una herramienta dedicada como un bug tracker, puede proporcionar toda la información y los pasos necesarios para reproducir un problema de forma estructurada, lo que facilita a los desarrolladores la reproducción del problema. Un informe estructurado de este tipo se denomina bug report.

Además, la información no se pierde y el proyecto no se olvida del problema; puede asignarlo a la persona adecuada y ver cuántos errores se están procesando o solucionando.

El proyecto LibreOffice proporciona un rastreador de errores que está abierto a la contribución de todos (https://bugs.documentfoundation.org).

Una herramienta muy similar es un helpdesk o sistema de tickets. Su objetivo no es tanto informar sobre problemas de software, sino ayudar a los usuarios con todo tipo de problemas y solicitudes, como por ejemplo el sitio web del proyecto.

El Helpdesk clásico es una línea directa de atención al cliente. Un cliente llama y notifica un problema, que se convierte en un ticket. El flujo de trabajo de un sistema de Helpdesk suele girar en torno a prioridades, niveles de escalamiento y tiempo de respuesta.

No todas las comunidades de código abierto ofrecen un sistema de este tipo, pero muchas empresas comerciales sí lo hacen. Por ejemplo, en el caso del proyecto LibreOffice, existe un sistema de tickets para que la infraestructura informe sobre problemas con los servidores y los servicios web.

Otra herramienta importante para la colaboración es un sistema de gestión de contenido (CMS). Como su nombre indica, ayuda a gestionar el contenido, sobre todo en el caso de los sitios web. Si quieres contribuir al contenido o al diseño del sitio web de un proyecto, familiarizarte con su CMS es el camino a seguir.

Los sistemas CMS, similares a las wikis, ayudan a estructurar el contenido en categorías e idiomas. Suelen ofrecer un editor WYSIWYG (“what you see is what you get` que Inglés significa `lo que ves es lo que obtienes”) e incrustan todo en una plantilla adecuada: los títulos, encabezados, diseño de página y entradas de menú que se realizan automáticamente, para que puedas concentrarte por completo en el contenido. Además, en caso de rediseñar una página, el contenido no desaparecerá, sino que se adaptará a la nueva plantilla.

Un sistema de gestión de documentos no debe confundirse con un sistema de gestión de contenidos. Mientras que un CMS está diseñado para mostrar contenidos en una plantilla predefinida, como para presentar un sitio web, un DMS se utiliza para la gestión de documentos como contratos, facturas, recibos, mensajes de correo electrónico y todo tipo de correspondencia.

Otra diferencia es que un CMS se utiliza a menudo para presentaciones públicas, mientras que un DMS se utiliza principalmente para gestionar documentos internos que no están destinados al público en general.

Como colaborador de un proyecto de código abierto, es menos probable que se encuentre con el sistema de gestión de documentos, ya que a menudo está reservado para roles específicos, como contabilidad o legal.

La documentación más conocida es la destinada a los usuarios finales, que explica cómo utilizar el software. Si no conoce alguna característica o función del programa, la documentación (que puede ir desde páginas de ayuda individuales hasta un libro completo) es su primer punto de referencia.

El sitio web de documentación, donde se explica el uso del software, suele ser uno de los sitios web más visitados junto al sitio web del producto, que presenta una descripción general del software y su comunidad.

Para su uso en entornos más grandes, como las implementaciones en una empresa, la documentación del administrador proporciona toda la información relevante para implementar el software a mayor escala. Esto incluye la conexión a bases de datos de usuarios y almacenamiento de archivos, la gestión centralizada de la configuración y el manejo de actualizaciones.

Otra categoría de documentación está dirigida a los desarrolladores y se denomina documentación para desarrolladores o documentación de arquitectura. Si eres desarrollador y quieres contribuir al código de un programa, esta documentación te informa sobre la arquitectura del software, los estándares de codificación, las herramientas y flujos de trabajo que se utilizan para trabajar en el software.

El proyecto LibreOffice ha publicado una guía para desarrolladores en su wiki para ayudar a los desarrolladores interesados a unirse a la comunidad (https://wiki.documentfoundation.org/Documentation/DevGuide).