Ticket de revisión "Introducción a Map Warper"

[mariajoafana]

The Programming Historian en español ha recibido la siguiente propuesta de tutorial "Instroducción a Map Warper" por parte de @mdcs87 y @apicon . Este tutorial se encuentra en estos momentos en fase de revisión por parte de @arojascastro @rivaquiroga @editio. Puede leerse en:

Texto

http://programminghistorian.github.io/ph-submissions/es/lecciones/introduccion-map-warper

https://github.com/programminghistorian/ph-submissions/blob/gh-pages/es/lecciones/introduccion-map-warper.md

Imágenes

https://github.com/programminghistorian/ph-submissions/tree/gh-pages/images/introduccion-map-warper

Puedes utilizar los números de línea proporcionados en la vista previa, si eso ayuda a señalar mejor tus comentarios. Pero puedes estructurar tu revisión como mejor te parezca.

En adelante, intervendré como editor durante el proceso de revisión. Tras haber leído la lección y haber enviado mis comentarios al traductor, mi rol consistirá en solicitar otra revisión por parte de uno de los miembros de nuestro comité editorial y gestionar las conversaciones que se produzcan en este foro.

Otros miembros de nuestra comunidad también están invitados a ofrecer sus comentarios de una manera constructiva; los comentarios deberán publicarse en este hilo de conversación, por lo que se recomienda haber leído nuestra guía para revisores (/es/guia-para-revisores) y tener en cuenta nuestra política contra el acoso (ver más abajo). No se aceptarán más comentarios por parte de la comunidad tras la publicación de la segunda revisión formal a fin de que el traductor pueda empezar a trabajar en los cambios solicitados. Cuando esto ocurra, publicaré un anuncio aquí.

Asimismo, me comprometo a mantener la conversación abierta a todo el mundo en GitHub. Pero si alguno de los participantes quiere ponerse en contacto en privado conmigo, puede escribirme un correo electrónico. También es posible contactar con nuestros 'ombudpersons'.

Política contra el acoso

El objetivo de 'The Programming Historian en español' es ofrecer un entorno abierto en el que la comunidad de participantes sean libres para analizar ideas, realizar preguntas, sugerir cambios, y pedir aclaraciones; también queremos que sea un espacio libre de acoso y hostigamento para todo el mundo con independencia de su género, identidad, orientación sexual, minusvalía, apariencia física, tamaño corporal, raza, edad, religión o conocimientos informáticos. No se tolerará ningún tipo de acoso o ataque ad hominem. Los participantes que violen esta regla podrán ser expulsados del proceso editorial a discreción del equipo editorial. Si presencias o sientes que has sido víctima de algún tipo de acoso, por favor, contacta con nuestros 'ombudspersons' (Maria José Afanador-Llach o Víctor Gayol - http://programminghistorian.org/es/equipo-de-proyecto).

[mariajoafana]

La primera ronda de revisión del tutorial la voy a hacer yo

[mariajoafana]

@mdcs87 y @apicon estoy revisando el tutorial pero el enlace donde se encuentra el Mapa cafetero en la Biblioteca Nacional no está funcionando. Por otro lado, les pido que suban la imagen del mapa a esta capeta: https://github.com/programminghistorian/ph-submissions/tree/gh-pages/images/introduccion-map-warper
Voy a esperar a tener acceso al mapa para poder adelantar la revisión

[mariajoafana]

Un primer comentario sobre el tutorial es añadir una sección donde se explique qué se va a aprender en el tutorial, es decir, enunciar claramente, qué tendrá la capacidad de hacer el usuario al finalizar el tutorial. Ver por ejemplo esto para el caso del tutorial de Voyant Tools.

[mdcs87]

Recibido María José, que pena por la tardía respuesta. Vamos a revisar esto para proporcionarles esa sección.

[mariajoafana]

Ok, quedo pendiente para continuar con el proceso de revisión

[mdcs87]

Hola María José. Nuevamente perdón por la tardanza. Como te habrás dado cuenta actualizamos el archivo del mapa utilizado, pusimos la versión en español.
Ya tenemos el texto que nos solicitas. Pero no sabemos si es necesario pasarlo en markdown o si lo podemos enviar a tu correo como archivo .doc. Mientras tanto lo pongo acá:
"En el tutorial se aprenderá a georreferenciar materiales cartográficos (mapas, planos, fotografías aéreas y otros), mediante la plataforma libre Map Warper, misma que no requiere instalación. En ese sentido, la lección es un complemento a otras lecciones de Programming Historian, referentes a la utilización de Sistema de Información Geográfica para el análisis espacial (Georeferencing in QGIS e Introducción a Google Maps y Google Earth). En esta ocasión, además de conocer las pautas técnicas esenciales para la georeferenciación de mapas antiguos, el usuario se familiarizará con el patrimonio cartográfico y su potencialidad en la investigación histórica."

Quedamos atentos y gracias por toda la comprensión.

[mariajoafana]

Hola Miguel, yo misma actualizo el archivo en md con la adición

[mariajoafana]

@mdcs87 y @apicon acá les dejo algunos comentarios, la P indica el párrafo donde se hace la sugerencia [acá]:(http://programminghistorian.github.io/ph-submissions/es/lecciones/introduccion-map-warper)

P 3: incluir el enlace a los tutoriales que ahí se citan
P 6: Sugiero que las instrucciones para utilizar Map Warper comiencen de una vez con el material con el que se va a trabajar. Es decir, en upload map dar la instrucciones para comenzar con ese mapa y dar la información para llenar algunos de los campos de la sección Edit y de ahí dar las instrucciones precisas de cómo trabajar con el mapa con las otras herramientas para la georreferenciación. Es deseable que el mapa con el que se va a trabajar esté dispoible ya en el repositorio de PH, en la sección assets y así garantizar el acceso al material y la sostenibilidad del tutorial. Si me envían el archivo del mapa me puedo encargar de subirlo.
P 9: El enlace al Mapa Cafetero de Colombia está roto. ¿Es este? http://babel.banrepcultural.org/cdm/ref/collection/p17054coll13/id/100
Si es así habría que indicar en qué resolución se debe descargar el mapa, aunque como lo mencioné es preferible que el archivo del mapa quede guardado en nuestro repositorio y que el usuario lo descargue de ahí para fines de hacer el tutorial.
Descargué una versión de este mapa en la mejor resolución y lo subí a MapWarper y luego le di clic a "create" y me sale: "Incomplete response received from application". No se si estoy haciendo algo mal o la aplicación está fallando.

Antes de seguir revisando el tutorial les pido por favor que revisen ese error para yo poder seguir haciendo el tutorial.

[mdcs87]

Frente al P3, aquí van los enlaces:
Georeferencing in QGIS https://programminghistorian.org/en/lessons/georeferencing-qgis
Introducción a Google Maps y Google Earth https://programminghistorian.org/es/lecciones/intro-a-google-maps-y-google-earth
Ya seguimos con los otros puntos.

[apicon]

P6:
Para cargar un material cartográfico en Map Warper, selecciona la pestaña “Upload Map”. Ahí podrás vincular la cartografía directamente desde un archivo local o anclarla desde un repositorio web por medio de la URL correspondiente. Para el ejercicio cargará el Mapa Cafetero de Colombia (fmapoteca_984_figac_16.jpg: http://catalogoenlinea.bibliotecanacional.gov.co/custom/web/content/mapoteca/fmapoteca_984_figac_16/fmapoteca_984_figac_16.jpg) o la cartografía de su preferencia. En este paso también puedes ir agregando los metadatos correspondientes del material cartográfico a georreferenciar. Para terminar el proceso de carga da click en la opción “Create”.

P9: El enlace es correcto, es el permalink del mapa proporcionado por la Biblioteca Nacional de Colombia. Sin embargo estamos esperando que ellos terminen la carga en la Mapoteca Digital (final de agosto).

Nota: La versión de Mapwarper.net, según Tim Waters, se encuentra en actualización debido a problemas técnicos con el almacenamiento en el servidor. Entonces propongo utilizar la versión japonesa para el desarrollo del tutorial, esto no cambiará la metodología, estética y propósito del tutorial. Para ello el link: http://mapwarper.net/ debe cambiar por https://mapwarper.h-gis.jp/?locale=en.

[mariajoafana]

@apicon y @mdcs87 gracias. La idea es que ustedes hagan las ediciones directamente en el archivo .md : https://github.com/programminghistorian/ph-submissions/blob/gh-pages/es/lecciones/introduccion-map-warper.md
Les recomiendo que cuando entren a hacer la edición antes de darle clic al botón de "edit" seleccionen el branch "edicion-map-warper" . Esto se selecciona al lado izquierdo de: ph-submissions/es/lecciones/introduccion-map-warper.md
Cuando terminen le dan clic a "Commit changes" y asegúrense que diga: Commit directly to the edicion-map-warper branch.
De esta manera estarán haciendo las ediciones al tutorial en un "branch" o rama del original y no directamente. Me cuentan si tienen alguna duda

[apicon]

@mariajoafana
Ya realizamos los cambios correspondientes, según la indicación, respecto al párrafo 3 y 9.
Frente al párrafo 6 en la Biblioteca quedaron de subir la visualización prontamente. Igual eso no modifica el buen desarrollo del tutorial.
Quedamos atentos de las próximas indicaciones.

[rivaquiroga]

@mariajoafana, ¿esta lección está lista ya para que la mire un segundo revisor?

[rivaquiroga]

@programminghistorian/spanish-team, María José no podrá seguir haciéndose cargo de la edición de esta lección, por lo que necesitamos que alguien asuma ese rol. @arojascastro, ¿podrías tú finalizar el proceso? Los autores ya incorporaron las sugerencias que ella les hizo.

[mdcs87]

Hola recibimos un mensaje al parecer relacionado con Omeka. Quedamos atentos.

[mariajoafana]

Perdón, puse el mensaje acá y era para otro ticket!

[arojascastro]

@programminghistorian/spanish-team, María José no podrá seguir haciéndose cargo de la edición de esta lección, por lo que necesitamos que alguien asuma ese rol. @arojascastro, ¿podrías tú finalizar el proceso? Los autores ya incorporaron las sugerencias que ella les hizo.

sí, pero necesito unos días

[arojascastro]

Hola,

Entiendo entonces que la revisión de los dos revisores se realizó y que el autor o autora ya hizo los cambios, ¿cierto? Si es así (por favor, confirmad) me leeré la lección y completaré el proceso editorial para publicarla en breve.

Quedo a la espera de una confirmación. Gracias.

[arojascastro]

Ah no, perdón, aún hay que buscar dos revisores. Vale. Pues me la leo y voy pensando en dos revisores externos. Perdón por la confusión.

[arojascastro]

Gracias por la paciencia y por escribir el tutorial.

Voy a hacer yo una primera revisión del tutorial.

Como revisor mi punto de vista es el siguiente:

Generalidades

• En la sección "¿Qué es Map Warper?" creo que se debería cambiar a "¿Qué es Map Warper y por qué utilizar esta herraminienta?" y añadiría un tercer párrafo explicando por qué utilizar esta herramienta y no otra. También creo que se podría hacer esta sección un poco más crítica o analítica y situar la herramienta dentro de los estudios espaciales o visuales y el mapeado; hay mucha investigación sobre el tema en las Humanidades Digitales. En fin, creo que hace falta un poco de contenido intelectual para convencer al lector de que vale la pena aprender a usar este programa.
• En la sección "Lo que aprenderás en este tutorial" creo que falta una lista de los principales "outputs" o bien de los pasos principales.
• En todo el tutorial: los títulos de apartado mejor en español o bien en inglés y traducción entre paréntesis
• Falta una conclusión en el que se haga un resumen de los principales pasos y se sugiera qué se podría en el futuro con los datos o el mapa creado. Es decir, ampliar la mirada a otras actividades. Aquí también se podrían dar referencias bibliográficas que discuten proyectos de mapeado o mencionar proyectos de HD que usan la herramienta.

Mis comentarios específicos por párrafo

• 1: software --> programa informático?
• 3: Programming Historian --> en cursiva. Además, creo que se debería aclarar aquí o en el párrafo 3 en qué idiomas está disponible la interfaz web. También habría que aclarar si es una herramienta open source y grauita o no.
• 11: ¿Qué lugar está representando en el material cartográfico? ¿cuáles fueron los cambios a lo largo del tiempo del espacio representado? ¿reconoces algún punto de referencia geográfica vigente? --> faltan comas separadoras o bien empezar con mayúscula.
• 14: falta un vídeo? En principio no aceptamos vídeos... solo imagen para ilustrar el texto. Por favor, aclarad esta cuestión.
• 15: sustituir guiones largos por paréntesis para poner la traducción
• 24: en lugar de nota, poner ese comentario en un destacado con >
• 26: como dije antes, creo que el tutorial termina de manera abrupta. Necesitamos una conclusión con un resumen de los principales pasos y por qué vale la pena usar esta herramienta.

En mi rol de editor: ahora buscaré otro revisor externo; no hace falta que hagáis ningún cambio aún @mdcs87 y @apicon. Esperaremos al segundo revisor y luego podréis hacer los cambios que consideremos oportunos.

[arojascastro]

Pregunta extra para @mdcs87 @apicon : el tutorial es individual, solo queréis escribir uno sobre esta herramienta, o este tutorial forma parte de una serie tutoriales sobre el mismo programa? Pregunto porque veo que la herramienta puede hacer más cosas.

[apicon]

@rivaquiroga, @arojascastro y @editio agradecemos sus valiosas revisiones.
Junto a @mdcs87 no encontramos retomando el tutorial.
Seguro lo resolveremos antes del 12 de abril.
Saludos!

[apicon]

Hola, @arojascastro y @rivaquiroga
Junto a @mdcs87 , tenemos un duda.
Al realizar la correspondiente actualización, desde el editor de Github, solo me da la opción de "Propose file change" y no logro ver los cambio realizados. Por el contrario, el perfil de Miguel tiene otra opción y muestra los cambios al instantes.
Quedamos atentos.

[arojascastro]

No acabo de entender el problema... os referís a estos cambios? https://github.com/programminghistorian/ph-submissions/commits/gh-pages/es/lecciones/introduccion-map-warper.md V

Veo que hicisteis modificaciones hace seis horas...

[mdcs87]

@arojascastro Gracias por tu respuesta. En efecto, nos confirmas que sólo los cambios que yo realizó están siendo incorporados. En ese caso, te pregunto es posible revisar los persimos de edición para que @apicon pueda hacer cambios que queden incorporados. Nuevamente gracias.

[rivaquiroga]

Como por la diferencia horaria Antonio probablemente no les pueda responder hasta mañana, trataré de ayudar yo por ahora.
@apicon, revisé los permisos y en el repositorio aparece que la invitación a editar te fue enviada, pero que aún no la aceptas. La reenvié nuevamente. Sugiero que chequees tu carpeta de spam en caso de que se haya ido para allá.

[apicon]

@rivaquiroga, encontré en spam una invitación pasada, la acepté, pero al editar me sigue registrado el siguiente mensaje: "You’re editing a file in a project you don’t have write access to. Submitting a change to this file will write it to a new branch in your fork apicon/ph-submissions, so you can send a pull request."

[rivaquiroga]

¡Ahora ni siquiera me apareces en la lista de miembros!
Te acabo de agregar de nuevo, así que deberías haber recibido una nueva invitación. Esperemos que esta vez resulte 🤞. ¡Estaré atenta!

[apicon]

¡Hecho!
Gracias @rivaquiroga.

[arojascastro]

¡Gracias @rivaquiroga ! Quedamos a la espera de los cambios para publicar lo antes posible.

[arojascastro]

Hola, alguna novedad? Me gustaría publicar pronto :)

Además de los cambios, necesitaré un breve texto biográfico de ambos autores.

Gracias

[arojascastro]

Por mi parte, cuando tenga los cambios de los autores, seguiré con:

• Crea una biografía para el autor
• Agrega una tabla de contenidos a la lección
• Agrega metadatos YAML al archivo de la lección
• Busca una imagen que represente la lección
• Informa al jefe de redacción para publicar
• Incorpora tu lección en nuestro Twitter bot
• Da las gracias a todo el mundo y difunde el tutorial

[arojascastro]

Hola @apicon @mdcs87 nos podéis dar una fecha aproximada de cuándo estará lista la lección? Ya queda muy poco, solo un último esfuerzo. Muchas gracias.

[mdcs87]

Hola @arojascastro, te presentamos nuestras excusas por lo tardío de la respuesta. @apicon y yo hemos estado bastante ocupados con la transición a la docencia virtual acá en Colombia. Tras discutirlo, acordamos que una fecha realista para enviar nuestra versión final sería Junio 16. Quedamos atentos.

[arojascastro]

Muy bien. Muchas gracias. Quedamos a la espera hasta el 16 de junio.

[arojascastro]

Hola @apicon y @mdcs87 alguna novedad? os recuerdo que necesito vuestras bios también. Gracias.

[apicon]

Hola @arojascastro , ya estamos por cerrarlo, en el transcurso de la semana lo confirmamos y enviamos las bios. Saludos.

[apicon]

Hola @arojascastro @rivaquiroga @mariajoafana @editio
Después de tanto confirmamos el cierre de la edición. Agradecemos mucho el tiempo y el trabajo de ustedes.
Quedamos atentos a todo.

Bios:
Anthony Picón Rodríguez, investigador del Laboratorio Digital de Arquitectura y Urbanismo de la Universidad Nacional de Colombia, bibliotecario de la Mapoteca Digital en la Biblioteca Nacional de Colombia y gestor de la red Razón Cartográfica.
https://orcid.org/0000-0001-6765-4146

Miguel Cuadros, Historiador, Universidad Industrial de de Santander. Master of Arts in History, State University of New York (Estados Unidos). Cuento con experiencia docente e investigativa en temas relacionados con la cartografía y el conocimiento geográfico. Docente cátedra en la Universidad Industrial de Santander,

[mdcs87]

Gracias por sus aportes y por la paciencia con los tiempos.

[arojascastro]

Muchas gracias a todos! Completo mis tareas y aviso a @rivaquiroga cuando esté listo! Prometo hacerlo esta semana.

[arojascastro]

Hola @rivaquiroga creo que ya podemos intentar incorporar la lección a Jekyll en programminghistorian/jekyll#1845

[rivaquiroga]

¡Muchas gracias a todos por su trabajo! Inciaré ahora el proceso de solicitud del DOI para la lección. Esto toma entre 1 y 2 días hábiles, así que lo más probable es que el martes por la tarde esté lista la publicación

[rivaquiroga]

La lección ya está publicada: https://doi.org/10.46430/phes0048

¡Muchas gracias a todos por su trabajo!

[arojascastro]

Muchas gracias a todos! @rivaquiroga una duda: quién incluye la lección al Twitter bot?

[rivaquiroga]

Tú como editor. Luego de eso, solo queda que lo anuncies por Twitter y celebrar.

[rivaquiroga]

Miguel en Twitter es @mdcs87 (igual que acá).
No estoy segura si Anthony tiene una cuenta.

[arojascastro]

Añadido al Bot y difundido en Twitter! Gracias todos <3

[rivaquiroga]

@mdcs87, @apicon, uno de los enlaces que incluyeron en su lección no se encuentra ya disponible: https://cienciassociales.uniandes.edu.co/historia-geografia/mapa-paisajes-coloniales. ¿Saben qué pasó con ese recurso o si está disponible en otra url?
Por el momento cambiamos el enlace al de la versión que estaba en Web Archive para que el sitio web de PH siguiera funcionando sin problemas.

[mariajoafana]

Recién se republicó actualizado acá: https://paisajescoloniales.com/
Ya lo corrijo en el tutorial