README.md

pow

Este repositorio busca solo utilizar la funcionalidad de tiquetes (issues) de GitHub para reportar algún problema de mapeo identificado en el mapa.

PoW quiere decir Proof of Work, o prueba de trabajo.

Invitamos a los interesados en el mapa, a darle "watch" (arriba a la derecha), para que sean notificados de los reportes, y poder responder tempránamente a estos.

Este espacio puede considerarse una alternativa (en español) del canal de Discord OSM-World > #questionable-edits (https://discord.com/channels/413070382636072960/763192797775265864).

Quieres reportar un cambio sospechoso

• Tienes que tener cuenta en GitHub. Realmente es fácil crearla.
• Vete al área de Issues: https://github.com/OSMLatam/pow/issues
• Ahí seleccionas "New Issue".
• En la lista de tipos de issues, selecciona: "Reporte de un problema en el mapa".
  • También puedes ir directamente haciendo click aquí.
• En el formulario, ponle un título corto sobre el problema.
• En la descripción, describe por qué es un cambio sospechoso.
  • Agrega la mayor descripción para entender mejor tu problema.
  • Si has detectado esto gracias a algún proceso automatizado, también lo puedes incluir.
  • Incluye tanta información como quieras (referencia a sitios externos, otros reportes).
• Agrega el "id del objeto y tipo de objeto" o "el id del cambio (changeset)". Puedes reportar varios objetos o changeset al tiempo, siempre y cuando estén relacionados con el mismo problema.
• Ponle la etiqueta (label) del país donde es el problema.
• ¡Listo! Espera un tiempo, que un analizador revisará tu reporte y comenzará a trabajar contigo.

Quieres ser un Analizador

• Tienes que tener cuenta en GitHub. Realmente es fácil crearla.
• Lo primero que debes hacer es darle Watch a este repositorio. Con eso te llegarán las notificaciones de los nuevos reportes.
• Revisa la página de Issues y si te interesa un reporte, comienza a analizarlo técnicamente y documentarlo en el tiquete.
• Si concluyes que es un problema, puedes escribirle al creador.
  • Escribe en el changeset(s). Incluye la URL del tiquete, donde están los resultados de tus análisis.
  • Puede usar otros medios de comunicación, como la mensajería de OSM, listas de distribución, Wiki, canales de Telegram, communities.
  • Si después de dos semanas no recibes respuesta del creador, entonces puedes reversar el cambio. Pero procura documentar tanto como puedas todo el proceso.
• Si consideras que no es un problema, puedes discutir al respecto con el usuario que reportó. Con esto se lleva a un acuerdo de cómo proceder.
• Si ya no hay más que hacer, cierra el tiquete.

Roles

Para el proceso hay tres roles:

• "usuario": es la persona que está creando un reporte aquí. Es la persona que identificó un problema en el mapa.
• "analizador": es la persona que analiza los reportes y se concluye sobre el cambio sospechoso.
• "creador": es la persona que creó o hizo un cambio en el mapa, el cual se considera un cambio sospechoso.

Flujo

El flujo es:

• Un "usuario" mientra está revisando el mapa ve algo anormal.
  • Pueden ser cambios masivos, borrados sin motivo, un cambio drástico, algo inexistente, exposición de datos personales y el comentario del cambio(s) no ofrece mucho soporte que sustente el cambio. Finalmente, es algo que no concuerda, pueden ser otras cosas diferentes a las que se acaban de indicar, pero hay algo de "sospechoso".
• El "usuario" identifica el id feature del objeto o del changeset.
• El "usuario" crea un tiquete aquí, explicando por qué considera que no es un cambio(s) normal. Pueden notificarse varios objetos o changesets al tiempo.
  • El título por defecto lo puedes cambiar o extender para dar una idea general de qué es.
  • Como parte del tiquete le pone la etiqueta del país (labels).
• El reporte es revisado por los "analizadores" que están suscritos a este repositorio.
  • Preferiblemente, un analizador del mismo país del problema, para que haya conocimiento local en la revisión.
• Después del análisis técnico del cambio, el "analizador" documenta esto en el tiquete. Este análisis puede incluir lo siguiente:
  • Etiquetas usadas si fue una adición o cambio.
  • Ver los cambios anteriores y posteriores en la historia del usuario.
  • Análisis de fotos satelitales de Bing o EOx (cloudless). Inclusive de Google, ya que no se está mapeando directamente, sino viendo diferencias, por lo tanto no se viola licencia.
  • Fotos de terreno de Mapillary, KartaView o Google StreetView.
  • Búsqueda de la zona en Internet (páginas web del lugar), imágenes, etc.
• Si se concluye que el cambio sí creó un problema en el mapa, el "analizador" o el "usuario" notifica al creador por medio de un mensaje en el chageset. En este mensaje se le indica que el cambio se considera sospechoso.
  • Como parte del mensaje, se debe hacer referencia al tiquete para sustentación técnica.
  • Además del changeset, se puede contactar al creador por mensaje directo, o por algún otro medio de comunicación. Es importante que le comunique sobre el análisis, o sea la URL del tiquete en PoW.
  • Esto le da tiempo al "creador" del cambio de revisarlo y tomar las acciones necesarias.
  • En el tiquete, el analizador pone "/remind me check in 2 weeks" para que GitHub le recuerde del tiquete en 2 semanas.
  • Si después de 2 semanas, no se ve respuesta del "creador", se hace un revert ( documentado ) o se le notifica al DWG.
    • Lo puede hacer el "analizador" o el "usuario".
  • Si se involucra al DWG, se pueden agregar las comunicaciones públicas con ellos: correos en listas de correo.
  • Una vez hecho el revert, se cierra el tiquete.
    • Lo puede hacer el "analizador" o el "usuario".
• Si no se concluye que el cambio creó un problema en el mapa, se habla con el usuario para aclarar por qué se reportó. Esta discusión conlleva a otro análisis o a cerrar el tiquete.

Etiqueta

Es importante que el usuario y el analizador escriban bastante soporte técnico. Esto le permitirá al creador entender por qué se considera sospechoso el cambio, y mejore sus habilidades de mapeo. Por otro lado, una buen cantidad de texto, permite tener una base documental, para que otras personas aprendar a identificar cambios sospechosos, y por qué no, que la comunidad mapee mejor.

Se recuerda a las personas que participen en el proceso mantener la etiqueta de OSM. Conservando los buenos términos, y con la suposición de la buena fé de la gente.