Ticket de revisión: "Introducción a la codificación de textos en TEI - Parte 2"

jenniferisasi commented 3 years ago

Programming Historian en español ha recibido la siguiente propuesta de lección: "Introducción a la codificación de textos en TEI - Parte 2" por parte de Nicolás Vaughan (@nivaca). La editora de esta lección será @jenniferisasi. Esta lección es la segunda parte de una secuencia de dos, y se encuentra en estos momentos en fase de revisión y puede leerse en:

Vista previa http://programminghistorian.github.io/ph-submissions/es/lecciones/introduccion-a-tei-2

Archivo https://github.com/programminghistorian/ph-submissions/blob/gh-pages/es/lecciones/introduccion-a-tei-2.md

Imágenes https://github.com/programminghistorian/ph-submissions/tree/gh-pages/images/introduccion-a-tei

Por favor, utiliza 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.

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 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 nuestra ombudperson.

Política contra el acoso

Esta es una declaración de los principios de Programming Historian en español y establece las expectativas para el tono y el estilo de toda la correspondencia entre los revisores, autores, editores y colaboradores de nuestros foros públicos.

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, diversidad funcional, 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 ombudsperson Silvia Gutiérrez De la Torre.

--

Con este ticket se cierra el preliminar #351 y en el que se decidió partir en dos una lección completa demasiado larga.

jenniferisasi commented 3 years ago

@nivaca quedó abierto así el Issue para la revisión de la segunda parte de tu lección. En los próximos días dejaré yo los primeros comentarios como editora (teniendo en cuenta los de la primera parte para no repetir) y, a la vez, empiezo a buscar revisores. ¡Gracias por tu paciencia!

nivaca commented 3 years ago

@jenniferisasi ¡Excelente! Quedo pendiente. Gracias.

rivaquiroga commented 3 years ago

@jenniferisasi, @nivaca, como las imágenes y archivos de ambas lecciones estaban todos juntos en una misma carpeta, tuve que separarlas para la publicación de la primera parte. Lo correspondiente a esta parte ahora está en intro-a-tei-2. @nivaca, mientras Jennifer hace la primera revisión, te pediría si puedes modificar los nombres de las imágenes teniendo en cuenta lo que aparece acá: https://programminghistorian.org/es/guia-para-autores#figuras-e-im%C3%A1genes. Como el nombre de esta lección termina con número, agreguémosle un guion para que no sea confuso (por ejemplo intro-a-tei-2-01.png).

nivaca commented 3 years ago

@rivaquiroga Ahora mismo lo hago.

nivaca commented 3 years ago

@rivaquiroga En el directorio images (y también en assets) encuentro dos subdirectorios: introduccion-a-tei e introduccion-a-tei-1. ¿Quieres que cambie los nombres de estos subdirectorios (introduccion-a-tei-1 y introduccion-a-tei-2)?

rivaquiroga commented 3 years ago

@nivaca, sí, eso mismo.

nivaca commented 3 years ago

@rivaquiroga Listo, ya cambié los nombres de imágenes según lo requerido.

rivaquiroga commented 3 years ago

¡Muchas gracias!

jenniferisasi commented 3 years ago

Gracias @rivaquiroga! no me había fijado yo en eso :/

jenniferisasi commented 3 years ago

@nivaca paso por aquí para dejar constancia de que estoy trabajando en la lectura de la lección para darte las primeras pautas editoriales. Voy despacio por los compromisos laborales a la vuelta de vacaciones, pero ahí voy. Espero tenerla pronto.

jenniferisasi commented 3 years ago

Llegué. Se me ha hecho larga de revisar puesto que, como ves, apunto numerosos cambios de estilo, sobre todo, que mejorarán la fluidez del texto para los lectores. Aquí van:

Comentario general:

asegurarse de que cada elemento TEI tiene una traducción al español entre paréntesis; por ejemplo “ (sello)”

Detalles de estilo y añadiduras que propongo:

[x] 4: Los detalles de la instalación de lo anterior están disponibles en la primera parte de la lección. ~~, por lo que los obviaremos aquí.~~
[x] 7: ~~como es obvio~~
[x] 7: una foto -> una imagen
[x] 8: , aunque esto será -> y esto será
[x] 8: fotografía -> imagen
[x] 8: apropiamente -> propiamente o apropiadamente
[x] 10: ~~De nuevo,~~ vale la pena que los codifiquemos ~~(así como hicimos atrás)~~ solo si esperamos eventualmente valernos de esa información para algo en concreto (p. ej. si quieremos extraer solo la información de los sellos postales).
[x] 10: falta el valor saludos para el atributo @type
[x] 10: añadiría algo más que “datos básicos” para porque también se incluye los datos de quien codifica.
[x] 14: Para no despistar al personal, diría que cambiáramos el comentario sobre a una nota a pie de página y seguir normal con
[x] 15: “mojones” (milestones) -> “mojones” o “marcadores” (milestones)
[x] 16: no es buena práctica suponer que todos nuestros lectores conocen a Salvador Dalí, por tanto, ~~es evidente que~~
[x] 17: elemento ~~(que más adelante volveremos a ver cuando hagamos normalizaciones)~~ a fin de conectarlos
[x] 26: Ahora bien, -> Además,
[x] 26 y 27: darle la vuelta a estos dos párrafos, comenzando con la idea de por qué es importante indicar el idioma en que está el texto principal, con la posibilidad añadida de poder indicar otros idiomas que aparezcan en el texto.
[x] 28: etexto -> texto (simple errata)
[x] Imagen entre 30 y 31: mejor crear el listado como parte del texto en vez de ofrecer una captura de pantalla; por accesibilidad.
[x] 32: nótese que hemos eliminado el de esto -> Ahora debemos eliminar puesto que …
[x] 32: hacen parte elemento
-> hacen parte del elemento
[x] 33: Solo nos hace falta una última cosa -> Solo nos queda una cosa / Solo nos falta una cosa
[x] 34: de TEI ~~, sin embargo,~~
debe estar contenido ~~—entre otras—~~ en un elemento
[x] 35: tres cosas aún. -> tres cosas más
[x] 35: quitar el paréntesis sobre la normalización de Sr.
[x] 35: leyendo el siguiente párrafo, creo que convendría decir que podemos hacer cuatro cosas más
[x] 36: Ahora bien, como -> ~~Ahora bien,~~ Como el texto … (si no se da a entender que hay una contradicción con incluir el atributo dentro del segundo addrLine
[x] 36: acaso lo más conveniente sea usar -> lo más conveniente es usar
[x] 39: encima del sello hallemos -> hallamos (simple errata)
[x] 39: ~~Hagámoslo así por mor de la exhaustividad.~~
[x] 41: Hemos decido no transcribir -> decidido (simple errata)
[x] 41: Aquí igual convendría añadir un enlace a la sección correspondiente a esto en la primera lección
[x] 45: añadir enlace al artículo de wikipedia de Soledad Acosta de Samper
[x] 45: -> Para nuestro segundo ejemplo hemos escogido un fragmento del Pequeño manual del estudiante de historia universal (sin fecha), de la escritora colombiana Soledad Acosta de Samper (1833-1913).
[x] 45: Como veremos, TEI es lo bastante potente como para lidiar con todos ellos. -> Como veremos, TEI ~~es lo bastante potente como para lidiar~~ nos permite trabajar con todos ellos.
[x] 53: ~~Ahora bien,~~ podemos ver que los textos
[x] 57: —entre quienes que yo me cuento— -> entre quienes yo me encuentro
[x] 58: creo que sería más conveniente indicar esto antes de mostrar el ejemplo, y decir por qué; Vamos a poner el … porque…
[x] 63: hay un error en #SA y #BN
[x] 64: Puede verse que no hemos usado el elemento para el caso de la Biblioteca Nacional de Colombia, sino el elemento , por cuanto se trata de una institución, no una persona de carne y hueso. -> Puesto que la Biblioteca Nacional de Colombia es una institución y no una persona, debemos usar el elemento
[x] 66: Darle la vuelta; Los textos 4, 5 y 6 forman parte de una sección que empieza en esta página, siendo el texto 2 su encabezado …
[x] 67: Puesto que no hace falta para seguir la lección, esto lo movería a una nota a pie de página, porque es información extra.
[x] 71 y 70, darles la vuelta ya que aparece antes que persName y title
[x] 74: quitar “sendos”
[x] 80: Ahora bien, las líneas -> ~~Ahora bien,~~ Las líneas
[x] 80: ~~(Este es un buen ejemplo del proverbial “corte y pega”, literalmente hablando.)~~
[x] 83-84: ¿cuál es la diferencia entre (de quoted, “citado”) y el texto citado (dentro de un elemento )?
[x] 85: Después de ir a la sección siguiente: (En la siguiente sección discutiremos cómo codificarla correctamente.) -> En la siguiente sección discutiremos cómo añadir que se trata de, además de una cita, de una nota a pie de página).
[x] 91: Es posible esta sea una nota marginal estructural con respecto a toda la sección. Si esto es correcto, sería una nota que iría ubicada al principio de esta y podríamos codificarla así: -> Vamos a considerar que se trata de una nota marginal estructural con respecto a toda y, así, irá ubicada al principio de esta así:
[x] 95: (Si quisiéramos introducir una bibliografía completamente estructurada, por ejemplo en el caso de una edición crítica, podríamos utilizar el elemento .) -> Este tipo de comentario va mejor en una nota para no interrumpir el texto
[x] 99: ~~(correspondiente al texto 8 en nuestro esquema).~~ ya lo dices en el título de la sección
[x] 107: ~~Ahora bien,~~
[x] 114: La imagen indica TEI P5 XML y no xHTML
[x] 120 y 123: no estoy segura de si este enlace en “resultado” va a funcionar, pero creo que es suficiente con la imagen de todos modos (para evitar errores de URL en futuro)
[x] 126: Esa primera oración me parece poco útil para nuestros usuarios, quienes leerán esta lección si no conocen TEI en profundidad, y esto puede que sólo los confunda.
[x] 129: deshacerse de la mención a una posible lección sobre XSLT

Como siempre, quedo pendiente a cualquier duda por si no he puesto algo claramente o si no estás de acuerdo con alguno de los cambios sugeridos.

nivaca commented 3 years ago

Gracias por tus comentarios, @jenniferisasi. Mañana mismo empiezo la corrección.

nivaca commented 3 years ago

Hola @jenniferisasi. Gracias de nuevo por la revisión. Hiciste una lectura muy juiciosa. Ya corregí todo lo que señalaste.

jenniferisasi commented 3 years ago

Perfecto @nivaca. Gracias por introducir los cambios pertinentes. Me pongo entonces a iniciar el proceso de revisión por pares. Como siempre, cuando tenga alguna novedad (espero pronto) lo haré por aquí.

jenniferisasi commented 3 years ago

@dxvidmr (pendiente de recibir su usuario de GitHub para que vea este mensaje) ha aceptado actuar de primer revisor para esta segunda parte de introducción a TEI. Siempre con la posibilidad de dar aviso de cualquier situación que lo impida, se compromete a entregar la revisión antes o para el 30 de septiembre.

David, como creo que es tu primera revisión para nosotros, te invito a que eches un vistazo a nuestra Guía para revisores antes de ponerte manos a la obra. Yo quedo a disposición de responder cualquier duda que surja durante el proceso.

dxvidmr commented 3 years ago

Buenas, me paso solamente a saludar. Gracias nuevamente por invitarme a la revisión, @jenniferisasi. Me encantó la primera parte de la lección, así que será un placer revisar esta segunda entrega, @nivaca. Os contactaré si me surgen dudas.

nivaca commented 3 years ago

Gracias, @dxvidmr. Quedo pendiente de tus comentearios.

rivaquiroga commented 3 years ago

@dxvidmr, qué bueno verte por acá :rocket:

dxvidmr commented 3 years ago

¡Buenas! Ando al fin revisando la lección. Estaba releyendo la parte 1 para hacerme una idea más completa de todo y me encontré con un error en el md. Os lo digo ahora para que no se me olvide y lo podáis revisar @jenniferisasi @rivaquiroga. Es una tontería:

En la sección "Validación sintáctica de documentos XML" (en la línea 116, si no me equivoco) hay dos enlaces en los que la sintaxis está al revés (paréntesis y corchetes) y por tanto no se visualizan bien.

Dice (https://codebeautify.org/xmlvalidator)[https://codebeautify.org/xmlvalidator] o (https://www.xmlvalidation.com)[https://www.xmlvalidation.com] y debiera ser [https://codebeautify.org/xmlvalidator](https://codebeautify.org/xmlvalidator) o [https://www.xmlvalidation.com](https://www.xmlvalidation.com).

Sigo, llegaré antes del 30 :)

rivaquiroga commented 3 years ago

¡Hola, @dxvidmr! Muchas gracias por avisarnos. Haremos la corrección para que los enlaces se vean bien.

dxvidmr commented 3 years ago

Terminé. Lo primero, felicitarte @nivaca por esta segunda entrega de la lección sobre TEI. Fue un placer poder revisarla.

Primero te dejaré unos comentarios e impresiones generales, y después comentarios específicos indicando la línea (siguiendo la previsualización). Espero no haberme extendido mucho con la revisión y, sobre todo, no sobrepasar mis funciones aquí. Intento explicar bien a lo que me refiero y sobre todo dar alternativas e ideas cuando veo algo que puede mejorarse, por eso parece una lista larga ;)

Comentarios generales

Con esta segunda entrega queda una lección introductoria a TEI muy muy completa. Se tocan muchas de las posibilidades que ofrece TEI, y en ese sentido creo que son un gran acierto los ejemplos. Con texto muy breves y sencillos has sido capaz de explicar el uso de muchísimas etiquetas distintas, y creo que las más importantes cuando se trabaja con textos literarios. Te felicito por la elección de los textos para la lección.
Es una lección larga y por eso quiero resaltar la forma en la que está escrita. Me ha gustado que el relato sea fluido, no se hace un tutorial duro. Tu forma de contar y explicar ayuda a mantener la atención. Usas fórmulas como el "continuemos" de la línea 12 que creo que ayudan a conectarse con la explicación y a generar una cercanía que yo, personalmente, agradezco.
Algunas aclaraciones/explicaciones y referencias a posibilidades de TEI que no se exploran aquí a veces puede parecer que desvían el foco del tutorial, pero como lector agradezco que me ofrezcan más. No querría terminar la lección solo sabiendo a codificar en TEI, también quiero saber cosas como que puedo después extraer toda la info de una etiqueta (por poner un ejemplo) o incluso hacer una publicación digital. Abre camino a que futuras lecciones de PH puedan ser enlazadas desde la tuya :)
En general creo que es fácil y cómodo de seguir, aunque sí pienso que puede ser algo abrumador si se llega sin saber nada, especialmente con la parte sobre citas y referencias bibliográficas o el uso de los metamark. Pero no veo que esto sea un problema, en la parte 1 se indica que la dificultad es media, estoy de acuerdo.
Sí quiero apuntar que cuando la información que se entrega de más (como un añadido aunque no sea sustancial a la lección) es más compleja, está bien que quede claro que son apuntes añadidos. Puede pasar que alguien no logre entender bien cierta cuestión, pero que no por eso decida abandonar la lección por encontrarla de un nivel superior a sus conocimientos. Por ejemplo, en la línea 121 comento en específico que hace falta esta aclaración.
En general toda la sección de la transformación podría no estar en el tutorial, pues transformaciones y publicación no forma parte de los objetivos y temas que se plantean en la introducción. Pero es un añadido perfecto para poder contextualizar uno de los usos de TEI (quizá uno de los más atractivos), y me encanta que te decidieras a incluirlo. Te hago entonces la propuesta de que esta sección se plantee como una especie de "Epílogo". Que quede claro al lector que los objetivos marcados para la lección se cumplen al terminar con el segundo ejemplo. (Y si la transformación también es un objetivo importante de la lección, entonces debería ser incluido en la introducción.)
En este sentido, se me hizo abrupto el cambio de sección entre las transformaciones y las conclusiones. Creo que me faltó un cierre al tema de transformaciones. Como propuesta, se me ocurre mencionar otras herramientas como teiPublisher (tienen una extensión en VScode que te genera previsualizaciones básicas directamente en el editor de texto, está muy bien) o CETEIcean (que creo que se está escribiendo ahora una lección para PH!).
Por último, apuntar que no se explica qué es y cómo se escriben comentarios en XML-TEI, y como se usan en los ejemplos de TEI creo que estaría bien una explicación. Ya aparecen en la parte 1, así que no sé si sería un poco raro explicarlos ahora. Es tan solo una sugerencia.

Comentarios específicos

(Utilizaré el formateado de código cuando te haga una propuesta de redacción, para que resalte y no se confunda.)

[x] 1: Creo que leí que de alguna forma ibais a indicar que esta era la parte 2, pero por si acaso, en esta primera línea incluiría el enlace a la parte 1 en "La primera".
[x] 5: ¿Qué te parece usar dos puntos (:) al final de la frase en vez de punto (.)? En la anterior lección cuando una línea se refería a la siguiente imagen lo indicasteis así. Y por lo que veo en está también en el resto de casos aquí.
[x] 8: Te hago una propuesta para ser más directo con la idea principal del párrafo: Para este primer ejemplo trabajaremos con la parte de atrás. La parte frontal de una postal contiene una imagen y no podríamos codificarla adecuadamente a menos que contuviera algún texto. [...] Creo que lo interesante aquí es recordar que trabajamos con texto y tiene menos importancia si tenemos o no la cara frontal de la postal.
[x] 9: Añadiría en la aclaración de "representación gráfica" algo como "simular la visualización" o "simular cómo se ve". Me encanta que hagas hincapié en que ahora lo importante es el marcado semántico.
[x] 13: Pienso si sería importante explicar en una nota qué es un elemento de autocerrado y que por eso lleva / al final. Después (¶15) se aclara algo más sobre este elemento, pero creo que es mucho concepto (autocerrado / elemento vacío) sin una nota. (Sobre esto digo más en mi comentario a la línea 39 más abajo).
[x] 14, 15, 16 y 17: En estos párrafos tenemos una enumeración de 3 cuestiones a notar en el ejemplo de TEI anterior. La tercera cuestión, a su vez, contiene otros 2 apuntes (uno en el ¶16 y otro en el ¶17). Se me hace un poco caos leer "Nótese, primero", "Segundo, nótese", "Veamos, asimismo" y dentro este último nuevamente "Primero" y en el siguiente párrafo (¶17) otra vez "Segundo", que se confunde con el anterior "segundo" (¶15). Por ejemplo, podría aclararse introduciendo con "Si nos fijamos en el TEI anterior podemos notar tres cuestiones:" Y después siguiendo un orden más claro: "Primero, [...]. Segundo, [...]. Tercero, [...]". Dentro del 3º (¶16) se me ocurre, en vez de usar la enumeración de nuevo, usar la fórmula "por un lado [...]" / "por otro lado [...]".
[x] 16: El añadido entre paréntesis sobre por qué usar <persName> en vez de <name> está muy bien, pero le sacaría los paréntesis para no tener paréntesis dentro de paréntesis. Otra alternativa es bajarlo a nota la pie.
[x] 22: El paréntesis "(Esto es lo que se denomina una “transcripción diplomática”.)" lo sumaría a la oración anterior en vez de que sea independiente. Se puede simplificar a: [...] (lo que se denomina "transcripción diplomática").
[x] 23: En la normalización habría que incluir también "moll" pues lo correcto en catalán es "molt". Esto me hace pensar en si palabras marcadas con <orig> y <reg> en tu ejercicio en verdad deberían estar marcadas con <sic> y <corr>. Tanto en el caso de molt como otros, el mismo "Dali" sin tilde o "adios" también sin ella. Creo que esto es más una decisión editorial de quien codifica y cómo usa las etiquetas, así que queda obviamente a tu criterio.
[x] 32: Eliminaría los paréntesis que encierran las dos últimas oraciones.
[x] 35: "Podemos hacer ~~al menos~~ varias cosas más."
[x] 36: Añadiría un "aquí" o "en este caso" después de "conveniente" → [...] lo más conveniente en este caso es usar [...]
[x] 37: La abreviatura "Sr" se corrige añadiendo un punto (.), pero en el texto no se ha descrito que se corregirá tal error. Imagino que en este punto cualquier lector entenderá por qué se añade un punto, pues hubo un caso similar líneas arriba, pero no está de más contar en el ¶35 que se hará esta corrección, antes de poner el código completo.
[x] 38: Se usa ahora la etiqueta <ab>, la cual fue introducida en la nota 2. Quizá no se deba dar por supuesto que todos los lectores han leído dicha nota, aunque no es responsabilidad del autor que un lector no lea las notas. Aún así, creo que no estaría de más decir entre paréntesis qué es y enlazar a las guías de TEI, e incluso remitir a la nota 2 de nuevo por si alguien se la saltó.
[x] 39: Ahora con el uso de <gap/> definitivamente creo que debe explicarse en una nota (como indiqué sobre la línea 13) lo que es una etiqueta vacía y de autocierre.
[x] 41: Me resulta un poco abrupto este apunte final. Quizá añadir un Como verás, [...].
[x] 45: Tras las fechas de nacimiento y muerte de Soledad Acosta creo que se ha colado ", su ."
[x] 46: Falta un espacio entre "p." y "59". Aquí y en las siguientes veces que se escribe (¶47 y en el teiHeader).
[x] 47: No se visualiza la imagen, creo que porque hay dos comillas dobles seguidas ("") en alt.
[x] 52: Para ser más claro, en el 5 y 6 usaría dentro del [...] en vez de "en el [...]". Explicitar más que unas partes contienen otras.
[x] 61: No comprendo bien la oración "Esta es precisamente la manera como el atributo @hand se suelen codificar en TEI". Te propongo algo más directo tomando la oración anterior y dándoles la vuelta: Esta es la manera de codificar manos en TEI usando el atributo @hand. El signo de numeral (#) significa que estamos haciendo referencia a un valor previamente definido.
[x] 70: Diría "el título del Génesis" en vez de "nombre".
[x] 74: El paréntesis sobre la caligrafía lo sumaría a la oración anterior en vez de hacerlo una oración suelta.
[x] 82: una texto → un texto
[x] 84: En el TEI del texto 8 se normaliza a "Génesis" con tilde sin usar las etiquetas que corresponden. En la siguiente referencia (texto 7), cuando la autora vuelve a usar "Genesis" sin tilde, sí se corrige usando choice, origy reg. Además, cuando en el TEI que acompaña a la línea 98 se añade la etiqueta note al texto 8 sí se indica la regularización de Génesis. Por lo tanto, el mismo fragmento aparece codificado de dos formas distintas.
[x] 88: El contenido de la nota ("La historia antes del Diluvio") lo pondría entre comillas dobles para que no se visualice como si fuera código.
[x] 92: En el TEI no tengo muy claro de dónde sale la línea última, creo que se ha colado: naturalmente alcanzaban <choice><orig>á</orig><reg>a</reg></choice> per
[x] 94: Unas comillas dobles mal colocadas: “información bibliográfica ligeramente estructurada (loosely-structured) “ → “información bibliográfica ligeramente estructurada" (loosely-structured)
[x] 95: El elemento title ya ha sido utilizado (en el teiHeader) quizá no es necesario volver a enlazarlo con las guías.
[x] 103: Una sugerencia de estilo: "la pregunta por cómo podemos [...]" → "preguntarse por cómo [...]"
[x] 104: Cambiaría de sitio algunas comas y eliminaría y añadiría unos artículo. Esta es mi propuesta: Sin embargo, también hay que saber que la codificación TEI es solo uno de los pasos en una cadena, probablemente muy extensa, de reutilización, procesamiento y análisis de textos con herramientas de las humanidades digitales.
[x] 105: TEI no permite mostrar → TEI nos permite mostrar
[x] 108: Creo que esto ya lo modificasteis en la parte 1, así que lo comento por unificar: cambiar "picaremos" por "haremos clic".
[x] 114: A mí en vez de Browse me dice en castellano, "Seleccionar archivo" (todo lo de más en inglés). Lo comento por si se quiere añadir que quizá no salga en inglés. De nuevo aquí se usa "picando" ("haciendo clic").
[x] 116: "picaremos" → "haremos clic". ¿"el servidor descargue el resultado en el navegador"? A mí directamente se me ha descargado en mi ordenador.
[x] 119: Quizá no estaba de más explicar cómo abrir el archivo .html que acabamos de descargar. Creo que trabajar con html en local no es algo que todo el mundo haya hecho. Por ejemplo, indicar que simplemente vale con arrastrar el archivo hasta el navegador que tengamos abierto.
[x] 121: La información del paréntesis sobre CSS está muy bien para quien lo entienda, pero si no sabes lo que es, es bien complejo. Quizá explicitaría que esta info es para entendidos en html/css y que si no, se puede pasar por encima como si nada a lo siguiente.
[x] 124: hay usado → ha usado
[x] 140 (nota 5): puedo parecer → puede parecer

Y hasta aquí mi revisión. De nuevo felicitaciones y agradecer a PH por contactarme. Quedo pendiente por si alguno de mis comentarios suscita duda o hay feedback de retorno.

Un abrazo.

nivaca commented 3 years ago

@dxvidmr Muchas gracias por tu cuidadosa lectura y tus comentarios. Voy a ponerme a hacer las correcciones. Un abrazo también.

jenniferisasi commented 3 years ago

Muchas gracias @dxvidmr por tan atenta revisión. Todos los comentarios me parecen acertados y es recomendable añadirlos. Veo que @nivaca ya se puso a trabajar, pero quería reafirmar que es necesario realizar los cambios.

nivaca commented 3 years ago

@dxvidmr Mil gracias por tus comentarios. Viste muchas cosas que yo había pasado por alto. Corregí casi todo lo que me sugeriste. Lo que preferí evitar fue la recomendación de explicar los comentarios en XML (y TEI). En una versión anterior de la Parte 1 hablé de eso, pero decidimos quitarlo por ser tema propio de XML. Quedo pendiente de lo que se ofrezca.

dxvidmr commented 3 years ago

Entendido lo de los comentarios, @nivaca! Creo que ha quedado muy bien así con el "epílogo" tras las conclusiones. Enhorabuena.

jenniferisasi commented 3 years ago

¡Gracías @nivaca por realizar los cambios tan rápidamente! Creo que tengo a una segunda revisora preparada para la última fase. Doy inicio al proceso para incluirla por aquí. Rosa Muñoz @romamendo realizará la segunda ronda de revisión por pares.

nivaca commented 3 years ago

Con gusto, @jenniferisasi. Quedo pendiente.

romamendo commented 3 years ago

¡Hola! Muchas gracias @jenniferisasi por invitarme a participar en este proceso. Ya he podido ponerme con calma a revisar esta lección y me está gustando mucho. ¡Gracias! Voy enviando algunas sugerencias menores sobre lo que he leído hasta ahora. Por favor, si alguno de mis comentarios no se entiende bien, avísenme.

[x] 7: Las postales tiene dos caras -> Las postales tienen dos caras
[ ] 9: El punto después del paréntesis: "Por ahora los pasaremos por alto.) Podemos" -> "Por ahora los pasaremos por alto). Podemos"
[x] 23: No sé si estoy equivocada, pero en el código:

¿La etiqueta no debería ser <reg> ?

[x] 24: Si no estoy equivocada en 23, habría que corregir las mismas etiquetas en el texto codificado
[x] 27: "Las líneas 6 y 7 (en el texto de la imagen) contiene texto en otra lengua" -> "Las líneas 6 y 7 (en el texto de la imagen) contienen texto en otra lengua"
[ ] 30: Me parece que el punto debe ir detrás del paréntesis: (Nótese que no hemos dejado un espacio en blanco entre cubistas y <corr>,</corr>.) -> (Nótese que no hemos dejado un espacio en blanco entre cubistas y <corr>,</corr>).
[x] 32: "y finalmente" -> "y, finalmente,"
[x] 36: Y cuarto, vamos codificar “Granada” -> Y, cuarto, vamos a codificar “Granada”
[x] 43: En el código completo habría que corregir lo señalado en los párrafos 23 y 24 sobre la etiqueta <reg>

Hasta aquí he podido avanzar por ahora. Por favor, si me pueden dar un poquito de tiempo hasta mañana... ¡Gracias!

jenniferisasi commented 3 years ago

Gracias @romamendo por dar inicio a tu revisión. Por supuesto, tome el tiempo que necesite. Veo que está prestando atención a cuestiones de ortografía y puntuación que, aunque son importantes y lo agradecemos de veras, contamos con un servicio para corregirlo más adelante. Por favor, indique al final de su revisión si el contenido le parece adecuado o si ha notado que falta algo de información para entender la lección. De nuevo, ¡mil gracias!

romamendo commented 3 years ago

Acabo de terminar. Primero leí solo la segunda lección, pero después he revisado tanto la primera como la segunda para tener la secuencia completa. Para entender mi valoración es importante que consideren que mi formación en este tema es media y, a pesar de ello, he podido seguir la lección con facilidad. La explicación es fluida. Es cierto que hay partes más densas, pero creo que están suficientemente explicadas y las notas aclaratorias ayudan a comprender las diferentes posibilidades de codificación, como en el caso de corr y reg. No sé si corresponde a la revisión, pero solo resaltaría un detalle que comenté en mi primera intervención que quisiera mencionar de nuevo porque me confundió al hacer la lectura del texto codificado:

[ ] 23: Parece que se hubiera producido un error en el texto codificado, pues se usa dos veces el elemento expan para regularizar las expresiones en medio y fotógrafos. En la explicación en 21 se explica que lo que debe usarse es reg para normalizar la ortografía.
[ ] 24 y 43: habría que revisar ese mismo detalle, porque al replicar el texto aparece el mismo elemento.

Sinceramente, gracias @jenniferisasi por esta posibilidad que me han brindado. Ha sido una oportunidad de aprendizaje.

nivaca commented 3 years ago

@romamendo Muchas gracias por tu cuidadosa lectura. Tienes toda la razón con respecto a los elementos y . Ya mismo los corrijo. Voy a tener en cuenta el resto de tus recomendaciones también.

romamendo commented 3 years ago

Al contrario, @nivaca ha sido muy grato leer ambas lecciones. Muchas gracias

nivaca commented 3 years ago

Muchas gracias, @romamendo, ya hice los cambios. (Solo no corregí los de la puntuación fuera del paréntesis.)

jenniferisasi commented 3 years ago

Muchísimas gracias @romamendo por tu atenta evaluación de la lección de Nicolás.

@nivaca apunto en mis tareas darle una última lectura a la lección en los próximos días para así proceder, en caso de estar todo bien ya, a enviar la lección a copyediting .

jenniferisasi commented 3 years ago

Bueno, pues creo que esta lección queda lista ya para hacer el copyediting, @rivaquiroga, que supongo hará @jamotilla? V

Va de entrada que veo que las notas no está funcionando en la preview. Lo miré y no le veo la razón.

Quedamos a la espera del penúltimo paso para publicar la lección

rivaquiroga commented 3 years ago

¡Hola! @jamotilla se encargará del copyediting 🚀

Respecto de las notas, sospecho que no se visualizan por la forma en que están escritas al final. Faltan los dos puntos después de la llamada. Es decir, esto:

[^1] Adoptaremos la convención...

habría que cambiarlo por

[^1]: Adoptaremos la convención...

nivaca commented 3 years ago

De acuerdo, @rivaquiroga, yo las arreglo mañana. Gracias.

jenniferisasi commented 3 years ago

@nivaca ya queda hecho el cambio, no te preocupes.

nivaca commented 3 years ago

Gracisa @jenniferisasi !

jamotilla commented 3 years ago

Hola a todos y todas, he realizado la primer revisión de la lección. @nivaca te pido por favor que revises los cambios sugeridos. Lo puedes consultar en el siguiente enlace: https://github.com/programminghistorian/ph-submissions/compare/Copyedit-introduccion-a-tei-2

Te felicito por la lección ¡Es buenísima!

nivaca commented 3 years ago

@jamotilla ¡Mil gracias por tu revisión! Estoy de acuerdo con todos tus comentarios.

rivaquiroga commented 3 years ago

¡Hola! Creo que solo faltaría el visto bueno final de @jenniferisasi para que podamos publicar esta lección :rocket: ¡Muchas gracias a todos!

jenniferisasi commented 3 years ago

@rivaquiroga estoy de acuerdo con los cambios. ¿Hago yo el pull request de la rama de José Antonio? Este proceso me ha pillado desprevenida.

rivaquiroga commented 3 years ago

Lo que te acomode más. Puedes hacerle merge directamente también si prefieres.

jenniferisasi commented 3 years ago

Dale, a ver si lo hago bien.

nivaca commented 3 years ago

@jenniferisasi y @rivaquiroga, mil gracias por todo el trabajo!!!

Pregunta técnica: cuando Riva dice "puedes hacerle merge" ¿se está refiriendo a hacerlo desde el repo de jekyll?

jenniferisasi commented 3 years ago

plas! Listo. Siguiendo con la idea de las "capas" se puede usar esta imagen o esta otra.

jenniferisasi commented 3 years ago

@jenniferisasi y @rivaquiroga, mil gracias por todo el trabajo!!!

Pregunta técnica: cuando Riva dice "puedes hacerle merge" ¿se está refiriendo a hacerlo desde el repo de jekyll?

No, el repo de ph-submissions donde @jamotilla había hecho su rama con las sugerencias de edición a tu tutorial. Ahora @rivaquiroga, como jefa, será quien mueva todo al repo ph-jekyll y nosotros podemos aprobar su PR cuando llegue el momento.

nivaca commented 3 years ago

No, el repo de ph-submissions donde @jamotilla había hecho su rama con las sugerencias de edición a tu tutorial. Ahora @rivaquiroga, como jefa, será quien mueva todo al repo ph-jekyll y nosotros podemos aprobar su PR cuando llegue el momento.

Ah, perfecto!

nivaca commented 3 years ago

plas! Listo. Siguiendo con la idea de las "capas" se puede usar esta imagen o esta otra.

La segunda es más bonita...? Lo que ustedes decidan está bien para mí.

programminghistorian / ph-submissions