Data Roda 45 > Coronapedia: Protocolos de colaboración

En esta data roda continuaremos con el proyecto de la Coronapedia, mejorando los protocolos de colaboración y su documentación, integrando así lo hecho en las dos sesiones pasadas.

Prerrequisitos:

Si intentas previamente dichos procesos e incluso sigues otros apartes después de la instalación, podremos invertir nuestro tiempo en usar el software más que en instalarlo y/o podremos ayudarte con preguntas específicas que tengas al respecto.

Agenda

  • Recapitulación.
  • Colaboración:
    • Infraestructuras
      • Tickets.
      • Telegram.
      • Hypothesis.
      • Docutopia.
      • Commits.
    • Perfiles:
      • Lectora.
      • Co-autora.

Recapitulación

Hemos hablado de "Inversión Infraestructural" (Susan Leigh Star): poner lo está en el fondo (infraestructuras) al frente y viceversa.

La Documentaton, Grafoscopio, Coronapedia, las Minipedias, entre otros son ejemplos de ello.

Pero dicha inversión infraestructurales deberíamos pensarlas en términos pendulares: fondo, frente, fondo, frente (y así sucesivamente).

Las dos data rodas anteriores han dado cuenta de ese movimiento, aunque no de forma explícita. Acá lo explicitaremos.

Lo que hicimos con Fossil (Data Roda 43), la consola de comandos, la conversión de formatos y otros "encantamientos marcianos", permitió que entre otras cosas tuvieremos este enlace de descargas y el contenido de portada:

Y por otro lado, el trabajo que se hizo en la anterior (Data Roda 44) permitió que hubiesen contenidos como este:

Vamos a hacer más clara esa relación entre fondo y frente, pensando roles de las personas que se aproximan a las plataformas.

Perfiles

Lectora

Una internauta encuentra una información que quiere sugerir para agregar a la Coronapedia. Veremos cómo hacerlo con un ejemplo, a través de diferentes infraestructuras.

Vía Tickets.

  • Hacemos click en el enlace que aparece en la parte superior de la Coronapedia, al inicio de página, que dice "Tickets". Veremos algo de este estilo:

  • Cliqueamos en "All Tickets", para verificar que nuestro ticket no está reportado. Veremos algo como esto:

    Listado de los tickets actuales

  • En caso de nuestro nuestro ticket (reporte) no esté, vamos a la página anterior y seleccionamos el enlace "New Ticket".

    Fossil, el sistema en el que hospedamos la Coronapedia, permite la creación la creación de tickets anónimos, es decir, sin registro en el sistema, como se muestra en la pantalla superior.

    El código alfanumérico está en la parte inferior de la página de nuevo ticket, es lo que se conoce como un textcha (un capcha hecho de texto), que permite filtrar robots que intenten crear SPAM o tickets con mensajes indeseados (publicidad, basura...). Ese textcha es el que usamos como contraseña (Password) para crear nuestro ticket.

  • Una vez hemos ingresado al sistema de tickets veremos un formulario como esto:

    Y una vez diligenciado, se vería de esta manera:

    :::info Importante

    • El título (Title) es un resumen breve (de una línea) pero específico, de lo que queremos que se haga con dicho ticket.
    • Al seleccionar el tipo de ticket (Type), la mayoría de ellos va a ser de tipo "Documentation".
    • En la versión y revisión colocamos aquella que aparece en la portada de la Coronapedia.
    • El correo es para fines de contactar a la persona en caso de que requeramos más información. No compartimos el correo con terceros no afiliados directamente al proyecto.
    • En el formato seleccionamos "Plain Text" (A futuro haremos disponible el formato Markdown). :::

    Si estamos de acuerdo con o que dice, hacemos click en el botón "Preview", lo cual nos mostrará una página como la siguiente, que es muy parecida a la anterior, pero nos muestra un "Descripción Preview" y un nuevo botón que dice "Publish":

    Podemos hacer ediciones sucesivas y cliquear el botón "Preview" hasta que el texto quede como lo deseamos.

  • Una vez tenemos el ticket completo y con la descripción adecuada cliquemos en el botón "Submit" y veremos algo como esto:

  • Al visitar el listados de todos los tickets, como mostramos en las intrucciones iniciales, veremos algo de este estilo:

    El enlace que aparece más a la izquierda con una combinación alfanumérica (para este ejemplo es b17049d198) es un identificador único para ese ticket, que asigna Fossil automáticamente. Si hacemos click allí, nos llevara a los detalles del ticket, que vimos anteriormente.

:::success Ejercicio:

Seguir las instrucciones dada acá, para crear un nuevo ticket en la Coronapedia. :::

Co-autora

Como co-autoras de la coronapedia, estamos en condiciones de escribir su contenido y dejar nuestros cambios en el registro histórico del proyecto. Esto quiere decir que tenemos acceso al repositorio, una copia del mismo en nuestras máquinas y que hemos solicitado permisos de desarrolladora en dicho repositorio. Partimos de dichos supuestos para continuar con esta sección. (Ver notas de la Data Roda 43).

:::info Para esta sección supondremos que tenemos el repositorio de Fossil de la Coronapedia abierto y que estamos ubicados, desde la consola de comandos, en la carpeta donde lo instalamos. :::

Cerrar un ticket

Seleccionar el ticket

  • Vamos al listado de todos los tickets y miramos aquellos cuyo "status" sea abierto ("Open").

  • Seleccionamos alguno de ellos, que estemos interesadas y en condiciones de cerrar y hacemos click en su identificador alfanumérico para ver la descripción detallada.

    Para este ejemplo vamos a iniciar con algunos que requieran poco esfuerzo de solución, en términos de la cantidad de cambios que haya que hacer al repositorio e iremos avanzando hacia aquellos más complejos.

  • El ticket que queremos editar es el db8586e885. Lo leemos y en caso de que sea pertinente corregirlo, ubicamos el archivo que hay hay que editar para resolver el ticket. Para este caso, el archivo es el la portada de la Coronapedia y el enlace que se sugiere agregar, iría en la subsección de iniciativas ciudadanas y activistas.

Realizar los cambios al repositorio

  • Actualizamos el repositorio

    fossil update

  • Abrimos el documento a actualizar y nos desplazamos en él a la subsección o lugar que deba modificarse y hacemos los cambios en el mismo, como se ve a continuación (línea 182):

    Modificación de un archivo para cerrar un ticket.

  • Antes de hacer commit, miramos el documento primero en nuestra máquina local, verificando que se encuentra en el estado deseado, debería verse algo como esto:

  • Una vez el documento se encuentra en el estado deseado, hacemos commit al repositorio, con un mensaje alusivo al ticket que estamos cerrando, incluyendo su identificador:

    fossil commit -m "Cerrando ticket [db8586e885]."

    Veremos un mensaje como:

    Round-trips: 1   Artifacts sent: 0  received: 0
New_Version: 37bcf63d35936d70e467946f8240f6e2a167ffdbe6926fa93a34bfd33d760ec9
Autosync:  https://{usuario}@mutabit.com/repos.fossil/coronapedia
Round-trips: 1   Artifacts sent: 2  received: 0
Sync done, sent: 3907  received: 3333  ip: xx.yy.zz.ww

    Y luego aparecerá en enlace actualizado en el repositorio remoto.

Revisemos qué ha pasado con la línea de tiempo del repositorio. Para ello, visitamos el enlace "Timeline" desde la portada de la Coronapedia. Veremos algo como esto:

Si nos damos cuenta, al colocar el identificador del commit entre paréntesis cuadrados, este enlace se activa en línea de tiempo.

:::info Recordatorio
Una introducción que hacemos habitualmente al tema de la gestión de código desde asuntos de gobernanza y participación la realizamos con este video:

Clay Shirky: ¿Como Internet transformará un día el gobierno? :::

Vamos a ver el commit en detalle, para lo cual hacemos click, en el identificador del checkin (para este ejemplo es 37bcf63d35). Veremos algo como esto:

Que se conoce como el diff, que es una manera pública y transparente de auditar cambios en las creaciones colectivas, es decir, permite ver formas de co-creación.

Cerrar el ticket en el formulario

Vamos al formulario del tiquet y lo diligenciamos, indicando el identificador del checkin que acabamos de hacer que cierra dicho ticket. Deberíamos ver algo como esto:

  • Status: Closed.
  • Resolution: Fixed.

Cliqueamos el botón "Submit" (enviar) y veremos esto en la línea de tiempo:

El identificador del ticket aparece tachado en la línea de tiempo y si hacemos click en él, veremos cuál fue el commit que lo cerró.