Resumen de la reunión de documentación

Reunión celebrada el día 2024-04-12 en el Google Meet anunciado en la agenda de WordPress de España

Datos de la reunión

Próxima reunión semanal

Revisión y estado de la guía de estilo para la traducción de la documentación

Segunda reunión del grupo de documentación. Se han tratado los siguientes temas:

Agradecimiento a @neusitas, por los múltiples y valiosos recursos que ha aportado al borrador de la guía de estilos.

Debate y progresos sobre la guía de estilo para la traducción de la documentación

Durante la semana se han realizado avances en el borrador de la guía de estilos para traducción, si bien todo lo añadido no se va a aprovechar. Los motivos principales se han debatido de forma pública en el espacio de documentación en el Slack de España y durante la reunión del día de hoy.

Progresos de la semana

Se acuerda que el borrador final no debe ser de un volumen elevado de documentación, más al contrario. Debemos aplicar la guía de estilo del español de España, su glosario y como guía gramatical la RAE, incluyendo las excepciones que en ella no estén incluidas porque, en su mayoría, serán de carácter técnico.

Dentro de la sección de lenguaje y gramática se incluirá un enlace al glosario. Y cuando salgan palabras que aún no están en el mismo, se hará la recomendación al equipo de traducción para discusión.

@nilovelez propone comenzar a traducir cuanto antes para que los documentos generados puedan ser revisados por los GTE locales y poder detectar y afinar la guía de estilos.

Se ha establecido la base de la creación de un artículo accesible estructurado de la siguiente manera:

  • El propio título del artículo ejercerá las funciones de H1
  • Se seguirá una jerarquía lógica y dentro de los parámetros de accesibilidad. Por tanto, el primer encabezado será siempre un H2, los posteriores en orden correlativo; H3, H4, etc.
  • Si se realizan enlaces se ubicarán siempre en un lugar determinado del artículo, facilitando así el acceso a estos.
  • Los enlaces tienden a perderse, por lo que @nilovelez de forma acertada propone incluir la posible respuesta que ofrece el enlace en cuestión. De esa manera, en caso de perderse el enlace, siempre estará documentada la respuesta del mismo. Esto es aplicable solo para enlaces o fuentes externas.

Documentar de manera inclusiva

Se intentará en la medida de lo posible reducir la utilización de artículos de género, siempre y cuando no produzca errores gramaticales o que por ello derive en un texto sin sentido dentro de la lengua española.

En este apartado, @visanju será el encargado de revisar y ajustar la guía de accesibilidad de inglés a español.

El afinado del borrador de la guía de estilos en forma de Google Docs durará una semana más, tras lo cual se debatirá que partes de la documentación global se deben traducir en primer lugar.

Cambio de día y hora de la reunión del grupo de trabajo de documentación

Por votación de todos los presentes y el voto delegado de @visanju a @josepmoran se acuerda por mayoría cambiar la reunión del equipo de documentación con carácter inmediato al martes a las 17:30 pm, dando lugar a que la próxima reunión se celebrará el próximo martes día 16 de abril del 2024.

Props a @estelaris por la revisión de este texto.

#documentacion #reuniones #agenda

Reunión del equipo de documentación, 12 de abril a las 11:00 h.

En esta ocasión nos reuniremos via Google Meet, puedes bajarlo antes de la reunión. El enlace es https://calendar.app.google/Sur8BzMrEq4DeDs67

Si te interesa la documentación y sabes traducir, te invitamos a participar. Si no sabes traducir, te explicamos cómo hacerlo.

  1. Quienes están presentes
  2. Voluntario(a) para tomar notas y subirlas al blog de es.wordpress.org
  3. Revisión de las notas y dudas en la Guía de estilo para traducir la documentación de WordPress
  4. Propuesta para nuevo dia y hora de la reunión semanal
  5. Foro abierto para preguntas, dudas, etc

Las notas y próximas agendas se publicarán en el blog del equipo.
#reuniones#documentacion

Estado de la Documentación 2024-04-11

Aquí está el resumen del estado de la documentación del Handbook de WordPress España de la última semana.

Tareas cerradas

Para el Contributor Day de Chiclana 2024 se creó una tarea para ser ejecutada durante el evento:

Tareas por publicar

Tareas revisión GTE

  • Ninguna tarea por revisar

Tareas en revisión

Tareas en desarrollo

Tareas fantasma

Tareas prioritarias

  • No hay tickets abiertos.

Tareas en espera

General

  • No hay tickets abiertos.

Manual de GitHub

Accesibilidad

  • No hay tareas pendientes

CLI

  • No hay tickets abiertos.

Comunidad

Core

  • No hay tickets abiertos.

Diseño

Diversidad

  • No hay tickets abiertos

Documentación

Formación

  • No hay tickets abiertos.

Fotos

Móvil

  • No hay tickets abiertos.

Marketing

Meta

  • No hay tickets abiertos.

Openverse

  • No hay tickets abiertos.

Plugins

Rendimiento

  • No hay tickets abiertos.

Soporte

Sostenibilidad

Temas

  • No hay tickets abiertos.

Test

  • No hay tickets abiertos.

Tide

  • No hay tickets abiertos.

Traducción

Tutorías

  • No hay tickets abiertos.

TV

#contributor-day, #documentacion, #github, #handbook

Resumen de la reunión sobre documentación

Reunión celebrada el día 2024-5-04 en el canal #documentación de WordPress de España

Datos de la reunión

Puedes leer la transcripción de la reunión a través de Slack.

Próxima reunión semanal

Control del proyecto

Primera reunión del grupo de documentación. Se han tratado los siguientes temas:

Agradecimiento a @luisrull, quien nos ha hecho saber que teníamos apuntado el enlace a la guía de traductores de forma errónea, lo cual es de agradecer por su parte.

Revisión y resolución de dudas sobre la guía de estilo para la traducción de la documentación

@neusitas aporta concreción sobre los siguientes temas:

  • Acrónimos
  • Siglas
  • Contracciones
  • Ejemplos en español en varios párrafos

Acrónimos: Se acuerda que los acrónimos son un subgénero de las siglas y no deben separarse como en inglés.

En este sentido, @glycymeris sugiere y se acepta la sugerencia de intentar aprovechar el rico léxico del idioma español para evitar inventar palabras.

@estelaris aporta un párrafo de ejemplo de las costumbres en inglés de realizar abreviaturas, aparte de este ejemplo, se añade la abreviatura en español «pq» (porque), como ejemplo de abreviatura en español que debe evitarse al realizar la adaptación de los textos escritos en inglés.

Se acuerda por consenso que no se realizarán traducciones literales, más bien se deben realizar adaptaciones al español de España de los textos escritos en inglés, otorgando cierta libertad para interpretar dichos textos.

También queda fijada la RAE como base para cualquier regla gramatical y, en la medida de lo posible, agregar el enlace correspondiente y la referencia para darle más autoridad al texto traducido.

El borrador de la guía de estilos en forma de Google Docs. Será la herramienta donde se realizarán las propuestas, comentarios y las posibles respuestas o debates que generen las mismas, dejando para la reunión semanal las posibles tomas de decisiones sobre lo publicado previamente en el borrador de la guía de estilos.

@neusitas revisará y afinará su sección sobre la base de los comentarios mencionados anteriormente, en caso de que aún queden dudas se solventarán en la siguiente reunión.

@visanju abre debate sobre el uso de las preposiciones cruzadas. @javiguembe aporta la sección de la RAE. Finalmente, @estelaris ha optado por eliminar la sección de preposiciones y realizar una explicación simple sobre el uso de las preposiciones.

@glycymeris anuncia la creación de una reunión semanal sobre la documentación del Spain-Handbook, de momento, sin fecha ni hora establecida.

Existen por parte de los asistentes ciertas reticencias sobre el día y hora acordados durante el Contributor Day de Torrelodones. Aunque se mantiene para la próxima semana el mismo día y hora, queda como uno de los puntos debatir en la próxima reunión un posible cambio de día y hora que tenga un consenso más amplio por los asistentes a la misma.

Props a @estelaris por la revisión de este texto.

#documentacion #reuniones #agenda

Estado de la Documentación 2024-04-04

Aquí está el resumen del estado de la documentación del Handbook de WordPress España de la última semana.

Tareas para Contributor Day Chiclana 2024

Para el Contributor Day de Chiclana 2024 se creó una tarea para ser ejecutada durante el evento:

Tareas cerradas

Tareas por publicar

Tareas revisión GTE

  • Ninguna tarea por revisar

Tareas en revisión

Tareas en desarrollo

Tareas fantasma

Tareas prioritarias

  • No hay tickets abiertos.

Tareas en espera

General

  • No hay tickets abiertos.

Manual de GitHub

Accesibilidad

CLI

  • No hay tickets abiertos.

Comunidad

Core

  • No hay tickets abiertos.

Diseño

Diversidad

  • No hay tickets abiertos

Documentación

Formación

  • No hay tickets abiertos.

Fotos

Móvil

  • No hay tickets abiertos.

Marketing

Meta

  • No hay tickets abiertos.

Openverse

  • No hay tickets abiertos.

Plugins

Rendimiento

  • No hay tickets abiertos.

Soporte

Sostenibilidad

Temas

  • No hay tickets abiertos.

Test

  • No hay tickets abiertos.

Tide

  • No hay tickets abiertos.

Traducción

Tutorías

  • No hay tickets abiertos.

TV

#contributor-day, #documentacion, #github, #handbook

Estado de la Documentación 2024-03-21

Aquí está el resumen del estado de la documentación del Handbook de WordPress España de la última semana.

Tareas para Contributor Day Torrelodones 2024

Para el Contributor Day de Torrelodones 2024 se creó una tarea para ser ejecutada durante el evento:

Tareas para Contributor Day Chiclana 2024

Para el Contributor Day de Chiclana 2024 se creó una tarea para ser ejecutada durante el evento:

Tareas cerradas

Tareas por publicar

  • No hay tareas por publicar.

Tareas revisión GTE

Tareas en revisión

Tareas en desarrollo

Tareas fantasma

  • No hay tickets abiertos.

Tareas prioritarias

  • No hay tickets abiertos.

Tareas en espera

General

  • No hay tickets abiertos.

Manual de GitHub

Accesibilidad

CLI

  • No hay tickets abiertos.

Comunidad

Core

  • No hay tickets abiertos.

Diseño

Diversidad

  • No hay tickets abiertos

Documentación

Formación

  • No hay tickets abiertos.

Fotos

Móvil

  • No hay tickets abiertos.

Marketing

Meta

  • No hay tickets abiertos.

Openverse

  • No hay tickets abiertos.

Plugins

Rendimiento

  • No hay tickets abiertos.

Soporte

Sostenibilidad

Temas

  • No hay tickets abiertos.

Test

  • No hay tickets abiertos.

Tide

  • No hay tickets abiertos.

Traducción

Tutorías

  • No hay tickets abiertos.

TV

#contributor-day, #documentacion, #github, #handbook

Estado de la Documentación 2024-03-14

Aquí está el resumen del estado de la documentación del Handbook de WordPress España de la última semana.

Tareas para Contributor Day Torrelodones 2024

Para el Contributor Day de Torrelodones 2024 se creó una tarea para ser ejecutada durante el evento:

Tareas para Contributor Day Chiclana 2024

Para el Contributor Day de Chiclana 2024 se creó una tarea para ser ejecutada durante el evento:

Tareas cerradas

  • No hay tareas cerradas

Tareas por publicar

Tareas revisión GTE

Tareas en revisión

Tareas en desarrollo

Tareas fantasma

  • No hay tickets abiertos.

Tareas prioritarias

  • No hay tickets abiertos.

Tareas en espera

General

  • No hay tickets abiertos.

Manual de GitHub

Accesibilidad

CLI

  • No hay tickets abiertos.

Comunidad

Core

  • No hay tickets abiertos.

Diseño

Diversidad

  • No hay tickets abiertos

Documentación

Formación

  • No hay tickets abiertos.

Fotos

Móvil

  • No hay tickets abiertos.

Marketing

Meta

  • No hay tickets abiertos.

Openverse

  • No hay tickets abiertos.

Plugins

Rendimiento

  • No hay tickets abiertos.

Soporte

Sostenibilidad

Temas

  • No hay tickets abiertos.

Test

  • No hay tickets abiertos.

Tide

  • No hay tickets abiertos.

Traducción

Tutorías

  • No hay tickets abiertos.

TV

#contributor-day, #documentacion, #github, #handbook

Estado de la Documentación 2024-03-07

Aquí está el resumen del estado de la documentación del Handbook de WordPress España de la última semana.

Tareas para Contributor Day Torrelodones 2024

Para el Contributor Day de Torrelodones 2024 se creó una tarea para ser ejecutada durante el evento:

Tareas para Contributor Day Chiclana 2024

Para el Contributor Day de Chiclana 2024 se creó una tarea para ser ejecutada durante el evento:

Tareas cerradas

Tareas por publicar

Tareas revisión GTE

Tareas en revisión

Tareas en desarrollo

Tareas fantasma

  • No hay tickets abiertos.

Tareas prioritarias

  • No hay tickets abiertos.

Tareas en espera

General

  • No hay tickets abiertos.

Manual de GitHub

Accesibilidad

CLI

  • No hay tickets abiertos.

Comunidad

Core

  • No hay tickets abiertos.

Diseño

Diversidad

Documentación

Formación

  • No hay tickets abiertos.

Fotos

Móvil

  • No hay tickets abiertos.

Marketing

Meta

  • No hay tickets abiertos.

Openverse

  • No hay tickets abiertos.

Plugins

Rendimiento

  • No hay tickets abiertos.

Soporte

Sostenibilidad

Temas

  • No hay tickets abiertos.

Test

  • No hay tickets abiertos.

Tide

  • No hay tickets abiertos.

Traducción

Tutorías

  • No hay tickets abiertos.

TV

#contributor-day, #documentacion, #github, #handbook

Estado de la Documentación 2024-02-29

Aquí está el resumen del estado de la documentación del Handbook de WordPress España de la última semana.

Tareas para Contributor Day Torrelodones 2024

Para el Contributor Day de Torrelodones 2024 se creó una tarea para ser ejecutada durante el evento:

Tareas para Contributor Day Chiclana 2024

Para el Contributor Day de Chiclana 2024 se creó una tarea para ser ejecutada durante el evento:

Tareas cerradas

  • No hay tareas cerradas

Tareas por publicar

Tareas revisión GTE

Tareas en revisión

Tareas en desarrollo

Tareas fantasma

  • No hay tickets abiertos.

Tareas prioritarias

  • No hay tickets abiertos.

Tareas en espera

General

  • No hay tickets abiertos.

Manual de GitHub

Accesibilidad

CLI

  • No hay tickets abiertos.

Comunidad

Core

  • No hay tickets abiertos.

Diseño

Diversidad

Documentación

Formación

  • No hay tickets abiertos.

Fotos

Móvil

  • No hay tickets abiertos.

Marketing

Meta

  • No hay tickets abiertos.

Openverse

  • No hay tickets abiertos.

Plugins

Rendimiento

  • No hay tickets abiertos.

Soporte

Sostenibilidad

Temas

  • No hay tickets abiertos.

Test

  • No hay tickets abiertos.

Tide

  • No hay tickets abiertos.

Traducción

Tutorías

  • No hay tickets abiertos.

TV

#contributor-day, #documentacion, #github, #handbook

Estado de la Documentación 2024-02-22

Aquí está el resumen del estado de la documentación del Handbook de WordPress España de la última semana.

Tareas para Contributor Day Zaragoza 2024

Para el Contributor Day de Zaragoza 2024 se creó una tarea para ser ejecutada durante el evento:

Resumen de la jornada (proporcionado por @AkireOrl)

  • Participantes en la mesa de Documentación: 2
  • Tareas realizadas: información sobre el trabajo de documentación, registro y visualización en GitHub, enlazado de la nueva cuenta con la cuenta correspondiente de WordPress.org y tareas del Repositorio de Prueba para coger soltura con el flujo de trabajo.
  • Tickets cerrados: 0
  • Tickets solicitados y en proceso: 1

Tareas para Contributor Day Torrelodones 2024

Para el Contributor Day de Torrelodones 2024 se creó una tarea para ser ejecutada durante el evento:

Tareas para Contributor Day Chiclana 2024

Para el Contributor Day de Chiclana 2024 se creó una tarea para ser ejecutada durante el evento:

Tareas cerradas

Tareas por publicar

  • No hay tickets abiertos.

Tareas revisión GTE

Tareas en revisión

Tareas en desarrollo

Tareas fantasma

  • No hay tickets abiertos.

Tareas prioritarias

  • No hay tickets abiertos.

Tareas en espera

General

  • No hay tickets abiertos.

Manual de GitHub

Accesibilidad

CLI

  • No hay tickets abiertos.

Comunidad

Core

  • No hay tickets abiertos.

Diseño

Diversidad

Documentación

Formación

  • No hay tickets abiertos.

Fotos

Móvil

  • No hay tickets abiertos.

Marketing

Meta

  • No hay tickets abiertos.

Openverse

  • No hay tickets abiertos.

Plugins

Rendimiento

  • No hay tickets abiertos.

Soporte

Sostenibilidad

Temas

  • No hay tickets abiertos.

Test

  • No hay tickets abiertos.

Tide

  • No hay tickets abiertos.

Traducción

Tutorías

  • No hay tickets abiertos.

TV

#contributor-day, #documentacion, #github, #handbook