Open jenniferisasi opened 11 months ago
La autora me ha contactado sobre su progreso. Va a incorporar a una co-autora para ampliar una sección de la lección y nos remitirán el primer borrador pronto.
Las autoras me han enviado su primer borrador (en formato Word), que leeré en los próximos días y, de ahí, añadiré a las co-autoras a este ticket para dejar mis comentarios.
Hola @jenniferisasi. If you'd like to share this draft with us, we'd be very happy to convert it into Markdown and generate a preview.
Hola @jenniferisasi. If you'd like to share this draft with us, we'd be very happy to convert it into Markdown and generate a preview.
Thank you @anisa-hawes and @charlottejmc! I will forward you the authors' email with the Word doc. I started reading it (very much enjoying it) but realized it would be easier to do this first pass already with the markdown paragraph numbers :)
Let me know if I can assist in anything in the meantime.
Hello @jenniferisasi. Thank you for sharing this. We'll make a start setting this up.
--
Hello Cláudia. Could you share the image files with us as .png
or .jpeg
files? Please email them to Charlotte (publishing.assistant[@]programminghistorian.org) so we can generate a preview of your draft 🙂
Thank you, Anisa
Hola @jenniferisasi, @ClaudiaDeSouza y @Dmwilsonfraites,
Puedes encontrar los archivos aquí:
Puedes revisar la vista previa de la lección aquí:
I would like to bring your attention to a couple small adjustments I made while processing this lesson:
[x] I edited the lesson structure very slightly, so that it reads this way:
## Introducción
### Objectivos de la lección
### Prerrequisitos
## ¿Qué es Wikidata?
## La estructura de Wikidata
## Paso a paso crear una cuenta y un elemento en Wikidata
## Describiendo datos de revistas en Wikidata
## Describiendo datos de personas en Wikidata
## Herramientas sugeridas para la descripción de elementos en Wikidata
## Referencias
I added the title Objectivos de la lección
and brought that paragraph down below the conceptual discussion of metadata etc. in the Introducción
, followed by the very short Prerrequisitos
. We can still edit the structure to turn some headings into subheadings, if necessary.
[x] I chose the lesson slug estructurar-metadatos-academicos-con-wikidata
because it seemed to describe the objective of the lesson, and it starts with an action verb, which aligns with our house style. This currently doesn't exactly 'fit' the provisional lesson title, but I believe the title may be adjusted in future revisions. We can also edit the slug as desired.
[ ] I will upload the images when I receive the files, and edit the markdown to link them in. Cláudia, the syntax which we use to embed figures within our lessons includes a 'figure caption' (which you've provided already), and an 'alt-text'. This descriptive element enables screen readers to read the information conveyed in the images for people with visual impairments, different learning abilities, or who cannot otherwise view them, for example due to a slow internet connection. It's important to say that alt-text
should go further than repeating the figure captions.
We have found Amy Cesal's guide to Writing Alt Text for Data Visualization useful. This guide advises that alt-text for graphs and data visualisations should consist of the following:
alt="[Chart type] of [data type] where [reason for including chart]"
What Amy Cesal's guide achieves is prompting an author to reflect on their reasons for including the graph or visualisation. What idea does this support? What can a reader learn or understand from this visual?
The Graphs section of Diagram Center's guidance is also useful. Some key points (relevant to all graph types) we can take away from it are:
For general images, Harvard's guidance notes some useful ideas. A key point is to keep descriptions simple, and adapt them to the context and purpose for which the image is being included.
Would you feel comfortable making a first draft of the alt-text for each of the figures? This is certainly a bit time-consuming, but we believe it is very worthwhile in terms of making your lesson accessible to the broadest possible audience. We would be very grateful for your support with this.
Thank you,
Charlotte ✨
Hola @ClaudiaDeSouza y @Dmwilsonfraites,
Your lesson has been moved to the next phase of our workflow which is Phase 2: Initial Edit.
In this phase, your editor Jennifer @jenniferisasi will read your lesson, and provide some initial feedback. Jennifer will post feedback and suggestions as a comment in this issue, so that you can revise your draft in the following phase (Phase 3: Revision 1).
%%{init: { 'logLevel': 'debug', 'theme': 'dark', 'themeVariables': {
'cScale0': '#444444', 'cScaleLabel0': '#ffffff',
'cScale1': '#535d7f', 'cScaleLabel1': '#ffffff',
'cScale2': '#444444', 'cScaleLabel2': '#ffffff'
} } }%%
timeline
Section Phase 1 <br> Submission
Who worked on this? : Publishing Assistant (@charlottejmc)
All Phase 1 tasks completed? : Awaiting figure images
Section Phase 2 <br> Initial Edit
Who's working on this? : Editor (@jenniferisasi)
Expected completion date? : June 30
Section Phase 3 <br> Revision 1
Who's responsible? : Authors (Cláudia + Dinah)
Expected timeframe? : ~30 days after feedback is received
Note: The Mermaid diagram above may not render on GitHub mobile. Please check in via desktop when you have a moment.
Hello @ClaudiaDeSouza y @Dmwilsonfraites,
Thank you very much for sending over the image files. I've uploaded them to the lesson's image folder, and you can see how they look in the lesson preview.
Can I just take this opportunity to point you back to my initial comment above? There are still a couple outstanding points – including alt-text for the images.
Thank you ✨
Hi Charlotte:
We agree with the changes in the lesson structure and the slug. Should we work with the alt-text directly on GitHub or can we share a Word document? I'm sorry, but I'm completely new to GitHub. I'm guessing we should click on the pencil icon to edit the file and then write the alt text where it says "Visual description of figure image"
{% include figure.html filename="es-or-estructurar-metadatos-academicos-con-wikidata-02.png" alt="Visual description of figure image" caption="Figura 2. Creación de elementos por fecha para Wikidata" %}
Is this correct?
-- Dinah M. Wilson Fraites, MIS Bibliotecaria I Departamento de Servicios Técnicos, Sección de Catalogación Sistema de Bibliotecas Universidad de Puerto Rico, Recinto de Río Piedras Tel 787-764-0000 ext. 85813 @.***
From: charlottejmc @.> Sent: Friday, June 7, 2024 10:44 AM To: programminghistorian/ph-submissions @.> Cc: DINAH M WILSON FRAITES @.>; Mention @.> Subject: Re: [programminghistorian/ph-submissions] Propuesta de lección: Promoviendo la ciencia abierta con Wikidata: visibilidad y apertura de los Portales de Revistas Académicas (Issue #589)
Hello @ClaudiaDeSouzahttps://github.com/ClaudiaDeSouza y @Dmwilsonfraiteshttps://github.com/Dmwilsonfraites,
Thank you very much for sending over the image files. I've uploaded them to the lesson's image folderhttps://github.com/programminghistorian/ph-submissions/tree/gh-pages/images/estructurar-metadatos-academicos-con-wikidata, and you can see how they look in the lesson previewhttps://programminghistorian.github.io/ph-submissions/es/borradores/originales/estructurar-metadatos-academicos-con-wikidata.
Can I just take this opportunity to point you back to my initial commenthttps://github.com/programminghistorian/ph-submissions/issues/589#issuecomment-2141672867 above? There are still a couple outstanding points – including alt-text for the images.
Thank you ✨
— Reply to this email directly, view it on GitHubhttps://github.com/programminghistorian/ph-submissions/issues/589#issuecomment-2154993504, or unsubscribehttps://github.com/notifications/unsubscribe-auth/BI5BCJ5LQKKSM5CAVFNNH4DZGHBNPAVCNFSM6AAAAABISQDQE6VHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDCNJUHE4TGNJQGQ. You are receiving this because you were mentioned.Message ID: @.***>
Hi @Dmwilsonfraites,
Thanks very much for your quick response!
Yes, 'Visual description of figure image' is exactly where we would need the alt-text. You're also right about how to edit the file – the only issue is I'm not sure you've been given write access to be able to make direct edits. My colleague @anisa-hawes will look into this for you!
In the meantime, you could simply write them in a comment below (e.g Figura 1 - [alt-text here]), and I can take care of adding them in myself.
Hello Dinah @Dmwilsonfraites,
I've sent you and Claudia @ClaudiaDeSouza invitations to join us here on GitHub as outside collaborators. This will give you both the Write access you'll need to edit your file directly here: /es/borradores/originales/estructurar-metadatos-academicos-con-wikidata.md.
Please let us know if you encounter any practical difficulties. Charlotte and I are here to help ☺️
[heart] Claudia D De Souza reacted to your message:
From: Anisa Hawes @.> Sent: Friday, June 7, 2024 3:13:50 PM To: programminghistorian/ph-submissions @.> Cc: Claudia D De Souza @.>; Mention @.> Subject: Re: [programminghistorian/ph-submissions] Propuesta de lección: Promoviendo la ciencia abierta con Wikidata: visibilidad y apertura de los Portales de Revistas Académicas (Issue #589)
Hello Dinah @Dmwilsonfraiteshttps://github.com/Dmwilsonfraites,
I've sent you and Claudia @ClaudiaDeSouzahttps://github.com/ClaudiaDeSouza invitations to join us here on GitHub as outside collaborators. This will give both of you the Write access you'll need to edit your file directly here: /es/borradores/originales/estructurar-metadatos-academicos-con-wikidata.mdhttps://github.com/programminghistorian/ph-submissions/blob/gh-pages/es/borradores/originales/estructurar-metadatos-academicos-con-wikidata.md.
Please let us know if you encounter any practical difficulties. Charlotte and I are here to help ☺️
— Reply to this email directly, view it on GitHubhttps://github.com/programminghistorian/ph-submissions/issues/589#issuecomment-2155043301, or unsubscribehttps://github.com/notifications/unsubscribe-auth/BGREO6Q6AKRWQM5JP6PZ6ATZGHE25AVCNFSM6AAAAABISQDQE6VHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDCNJVGA2DGMZQGE. You are receiving this because you were mentioned.Message ID: @.***>
Thank you very much! What deadline do we have for for completing this? Next week I'll be out of the office, I could start on Monday, June 17th. Please let me know if it's possible.
Dear @ClaudiaDeSouza.
There's no immediate rush to complete the alt-text
. We can slot that in whenever we receive it. Jennifer is reading the lesson already, and will return with initial feedback for you by ~30 June.
Thank you.
Estimadas autoras @ClaudiaDeSouza y @Dmwilsonfraites, felicidades por una lección tan informativa a la vez que clara en sus instrucciones. El orden de estas así como el estilo y los ejemplos son excelentes y en general no necesitan revisión. Como indico abajo, lo único que recomiendo para mejorar este trabajo es una sección de conclusión más fuerte. El resto de mis sugerencias son mínimas y más que nada para facilitar la lectura; puede que los revisores pidan más cambios pero como edición primera no va a ser necesario mucho trabajo.
Los siguientes números corresponden al párrafo que pueden ver en la previsualización:
Quedo al pendiente para aclarar cualquier duda que estos comentarios pudieran ocasionar y dar ya comienzo a la tercera fase de nuestro workflow. ¡Gracias!
Hola Claudia @ClaudiaDeSouza y Dinah @Dmwilsonfraites,
Your lesson has been moved to the next phase of our workflow which is Phase 3: Revision 1.
This phase is an opportunity for you to revise your draft in response to @jenniferisasi's initial feedback.
I've checked to ensure that you have the 'write access' you'll need to edit your draft directly.
We ask authors to work on their own files with direct commits: we prefer you don't fork our repo, or use the Pull Request system to edit in ph-submissions. You can make direct commits to your file here: /es/borradores/originales/estructurar-metadatos-academicos-con-wikidata.md. @charlottejmc and I can help if you encounter any practical problems!
When you and Jennifer are all happy with the revised draft, we will move forward to Phase 4: Open Peer Review.
%%{init: { 'logLevel': 'debug', 'theme': 'dark', 'themeVariables': {
'cScale0': '#444444', 'cScaleLabel0': '#ffffff',
'cScale1': '#535d7f', 'cScaleLabel1': '#ffffff',
'cScale2': '#444444', 'cScaleLabel2': '#ffffff'
} } }%%
timeline
Section Phase 2 <br> Initial Edit
Who worked on this? : Editor (@jenniferisasi)
All Phase 2 tasks completed? : Yes
Section Phase 3 <br> Revision 1
Who's working on this? : Authors (@ClaudiaDeSouza + @Dmwilsonfraites)
Expected completion date? : July 21
Section Phase 4 <br> Open Peer Review
Who's responsible? : Reviewers (TBC)
Expected timeframe? : ~60 days after request is accepted
Note: The Mermaid diagram above may not render on GitHub mobile. Please check in via desktop when you have a moment.
Hola Jennifer, Muchas gracias por su amable mensaje. Apreciamos el tiempo dedicado a revisar nuestro trabajo y tus comentarios. Verás que puse "OK, listo" para los que ya he atendido. Sin embargo, tengo algunas preguntas/dudas para los demás:
2: "por lo tanto, sería algo como 'datos sobre los datos'. Precisamente, los metadatos son 'datos que hablan... " OK, listo 2: "así como facilitando la interoperabilidad" - facilitan OK, listo 2: "disponible en línea, ya que son esenciales..." - y son OK, listo 3: "(lo que en inglés serían los Open Data)" - (Open Data en inglés) OK, listo 5: "de la investigación. Abordaremos las revistas..." - de la investigación. Como caso de estudio abordaremos..." OK, listo 13: añadir enlace a referencia de "web semántica" _Jennifer, no sé cómo hacerlo. Por favor ¿me podrías indicar cómo incluir un enlace directamente en la plataforma de GitHub?__ 16-27: sugiero hacer submenús con cada "elemento" para que los lectores puedan referirse a ellos con un vistazo rápido ¿A qué te refieres con "submenús"? 30: "En este caso (caso), debes de dirigirte" - la palabra caso está duplicada, creo OK, listo_ 37: indicar explícitamente si se trata de valores fijos, es decir, de un vocabulario controlado al que tenemos que ceñirnos los usuarios o si es de entrada libre (para que los lectores no tengan que esperar a ir a esa fase de añadir datos para corroborarlo) Aquí no me queda claro a cuál apartado. ¿Al de crear un nuevo elemento? 70: Necesitamos un párrafo de cierre de la lección, al igual que si de un artículo tradicional se tratara. Un resumen de lo aprendido, las posibles aplicaciones y la sugerencia a seguir aprendiendo con la lección mencionada bastarían. Entendido, estamos trabajando en eso.
¿Podrías brindarnos tu ayuda, por favor?" Quedamos pendiente. Saludos.
Estimadas autoras. Gracias por revisar la lección tan rápidamente.
¡Claro, aquí para ayudar!
Por ejemplo, la referencia a wikipedia quedaría así: [web semántica](https://es.wikipedia.org/wiki/Web_semántica)
16-27: No fui clara, perdón, y si no lo veis útil o es muy enredado podéis ignorarlo. Quería decir añadir, más bien, un titulo al párrafo que habla de cada elemento, usando tres símbolos de almohadilla (#) para indicar que están dentro de ## La estructura de Wikidata
. Por ejemplo:
Párrafo
Párrafo
Párrafo
37: Sí, eso es. Me refiero a apuntar directamente que la propia herramienta nos va a ayudar a seleccionar la etiqueta más adecuada a cada instancia gracias a un un menú desplegable o vocabulario controlado dado por Wikidata (el texto es de entrada libre pero aparece rápidamente el menú). Es conveniente indicarlo para que los lectores con menos experiencia en wikidata/datos/etc. sepan que la propia herramienta les va a echar una mano con el desarrollo de etiquetas y no tienen que desarrollar su vocabulario propio.
Comprobando esto, veo que al empezar a escribir "ser huma..." aparece un menú despegable del que se puede seleccionar la etiqueta que queremos usar :)
Cualquier otra duda, quedo al pendiente para ayudar.
Hola Jennifer, Muchísimas gracias por tus explicaciones tan claras. He revisado nuevamente el documento y ya incluí un pequeño apartado de conclusiones. En este momento, estoy de acuerdo en proceder con la Fase 4: Revisión Abierta por Pares. Gracias de nuevo por tu ayuda ❤️ Saludos.
Hola Claudia @ClaudiaDeSouza y Dinah @Dmwilsonfraites,
Your lesson has been moved to the next phase of our workflow which is Phase 4: Open Peer Review.
This phase is an opportunity for you to hear feedback from peers in the community.
Jennifer @jenniferisasi will invite two reviewers to read your lesson/translation, test your code, and provide constructive feedback. In the spirit of openness, reviews will be posted as comments in this issue (unless you specifically request a closed review).
After both reviews, Jennifer will summarise the suggestions to clarify your priorities in Phase 5: Revision 2.
%%{init: { 'logLevel': 'debug', 'theme': 'dark', 'themeVariables': {
'cScale0': '#444444', 'cScaleLabel0': '#ffffff',
'cScale1': '#535d7f', 'cScaleLabel1': '#ffffff',
'cScale2': '#444444', 'cScaleLabel2': '#ffffff'
} } }%%
timeline
Section Phase 3 <br> Revision 1
Who worked on this? : Authors (@ClaudiaDeSouza + @Dmwilsonfraites)
All Phase 3 tasks completed? : Yes
Section Phase 4 <br> Open Peer Review
Who's working on this? : Reviewers (@semanticnoodles + @pedronilsson)
Expected completion date? : 16 September
Section Phase 5 <br> Revision 2
Who's responsible? : Authors (@ClaudiaDeSouza + @Dmwilsonfraites)
Expected timeframe? : ~30 days after editor's summary
Note: The Mermaid diagram above may not render on GitHub mobile. Please check in via desktop when you have a moment.
Durante las Fases 2 y 3, proporcioné comentarios iniciales sobre esta lección y trabajé con @ClaudiaDeSouza y @Dmwilsonfraites para completar una primera ronda de revisiones.
En la Fase 4 de revisión por pares en abierto, invitamos a otros miembros de nuestra comunidad a ofrecer comentarios.
Doy así la bienvenida a Giulia Osti @semanticnoodles y Pedro Nilsson-Fernàndez @pedronilsson. Al participar en este proceso de revisión por pares, están contribuyendo a la creación de un recurso técnico útil y sostenible para toda la comunidad. ¡Gracias!
Por favor, lean la lección, prueben los pasos a seguir y publiquen su reseña como un comentario en este ticket antes del lunes 16 de septiembre o escríbanme sin problema en caso de que no puedan completar su reseña para la fecha señalada.
Guía para revisores:
La vista previa de la lección:
-- Notas:
Política contra el acoso
En esta sección encontrarás una declaración de los principios que deben regir Programming Historian en español; también ofrece una pauta sobre el tono y el estilo que debiera predominar en todos los intercambios que tienen lugar en nuestros foros entre traductores, autores, revisores y editores.
El objetivo de Programming Historian en español es ofrecer un entorno abierto en el que la comunidad de participantes sea libre 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 ombudsperson Silvia Gutiérrez De la Torre.
Además de los comentarios a los que llamo arriba, @silviaegt me dejó unos comentarios muy útiles ya por email y que podemos tomar en cuenta prontamente:
¡Gracias Silvia!
Gracias Jennifer, trabajaré con la incorporación de estas sugerencias.
-- Dinah M. Wilson Fraites, MIS Bibliotecaria I Departamento de Servicios Técnicos, Sección de Catalogación Sistema de Bibliotecas Universidad de Puerto Rico, Recinto de Río Piedras Tel 787-764-0000 ext. 85813 @.***
From: Jennifer Isasi @.> Sent: Wednesday, July 17, 2024 1:28 PM To: programminghistorian/ph-submissions @.> Cc: DINAH M WILSON FRAITES @.>; Mention @.> Subject: Re: [programminghistorian/ph-submissions] Propuesta de lección: Promoviendo la ciencia abierta con Wikidata: visibilidad y apertura de los Portales de Revistas Académicas (Issue #589)
Además de los comentarios a los que llamo arriba, @silviaegthttps://github.com/silviaegt me dejó unos comentarios muy útiles ya por email y que podemos tomar en cuenta prontamente:
¡Gracias Silvia!
— Reply to this email directly, view it on GitHubhttps://github.com/programminghistorian/ph-submissions/issues/589#issuecomment-2233830750, or unsubscribehttps://github.com/notifications/unsubscribe-auth/BI5BCJYHFZ4V4R5A4WISIT3ZM2ST3AVCNFSM6AAAAABISQDQE6VHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDEMZTHAZTANZVGA. You are receiving this because you were mentioned.Message ID: @.***>
Saludos Jennifer,
Acabo de incorporar todas las sugerencias ofrecidas por Silvia. Continuaré con la redacción de los textos para las imágenes. Por favor, háganme saber si detectan algún error, es la primera vez que uso GitHub.
Atentamente,
Dinah
-- Dinah M. Wilson Fraites, MIS Bibliotecaria I Departamento de Servicios Técnicos, Sección de Catalogación Sistema de Bibliotecas Universidad de Puerto Rico, Recinto de Río Piedras Tel 787-764-0000 ext. 85813 @.***
From: DINAH M WILSON FRAITES @.> Sent: Wednesday, July 17, 2024 5:01 PM To: programminghistorian/ph-submissions @.>; programminghistorian/ph-submissions @.> Cc: Mention @.> Subject: Re: [programminghistorian/ph-submissions] Propuesta de lección: Promoviendo la ciencia abierta con Wikidata: visibilidad y apertura de los Portales de Revistas Académicas (Issue #589)
Gracias Jennifer, trabajaré con la incorporación de estas sugerencias.
-- Dinah M. Wilson Fraites, MIS Bibliotecaria I Departamento de Servicios Técnicos, Sección de Catalogación Sistema de Bibliotecas Universidad de Puerto Rico, Recinto de Río Piedras Tel 787-764-0000 ext. 85813 @.***
From: Jennifer Isasi @.> Sent: Wednesday, July 17, 2024 1:28 PM To: programminghistorian/ph-submissions @.> Cc: DINAH M WILSON FRAITES @.>; Mention @.> Subject: Re: [programminghistorian/ph-submissions] Propuesta de lección: Promoviendo la ciencia abierta con Wikidata: visibilidad y apertura de los Portales de Revistas Académicas (Issue #589)
Además de los comentarios a los que llamo arriba, @silviaegthttps://github.com/silviaegt me dejó unos comentarios muy útiles ya por email y que podemos tomar en cuenta prontamente:
¡Gracias Silvia!
— Reply to this email directly, view it on GitHubhttps://github.com/programminghistorian/ph-submissions/issues/589#issuecomment-2233830750, or unsubscribehttps://github.com/notifications/unsubscribe-auth/BI5BCJYHFZ4V4R5A4WISIT3ZM2ST3AVCNFSM6AAAAABISQDQE6VHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDEMZTHAZTANZVGA. You are receiving this because you were mentioned.Message ID: @.***>
The Programming historian en español ha recibido una propuesta de lección con el título provisional "Promoviendo la ciencia abierta con Wikidata: visibilidad y apertura de los Portales de Revistas Académicas" por Cláudia De Souza @ClaudiaDeSouza y @Dmwilsonfraites Dinah Wilson Fraites. Los objetivos de la lección son:
A fin de promover una publicación a tiempo, se ha acordado que la lección se entregará hacia mediados de ~diciembre de 2023~ febrero de 2024. La autora contactará con antelación con la editora si no puede cumplir con la fecha de entrega y necesita una ampliación.
Si la lección no es entregada en la fecha acordada, la editora intentará contactar con el autor o autores de la lección. Si no recibe noticias, el ticket se cerrará. Éste podrá abrirse en el futuro a petición del autor o autores.
El principal contacto para esta lección es, por ahora, @jenniferisasi. Si se produce algún problema, el autor puede contactar con nuestra ’ombudsperson' (Silvia Gutiérrez de la Torre - http://programminghistorian.org/es/equipo-de-proyecto).