Estado de la Documentación 2024-05-16

Estás leyendo el resumen del estado de la documentación del Handbook de WordPress España de la última semana.

Desde esta semana, se incluye un nuevo proyecto a los que se están realizando dentro del Equipo de Documentación de WordPress España, el proyecto de Traducción y localización de la documentación de los usuarios finales.

Puedes encontrar todos los proyectos en los que está trabajando el equipo de documentación, así como las tareas que se están realizando en:

Revisores: @glycymeris, @josepmoran

Menciones: @glycymeris, @javiercasares, @josepmoran, @martatorre, @visanju, @pilargarcia.
Props: @estelaris

Tareas cerradas

General

  • Ninguna tarea cerrada

Manual de GitHub

  • Ninguna tarea cerrada

Traducción y localización

Tareas por publicar

General

Manual de GitHub

  • Ninguna tarea por publicar

Traducción y localización

  • Ninguna tarea por publicar

Tareas revisión GTE

General

Manual de GitHub

Traducción y localización

  • Ninguna tarea en revisión

Tareas en revisión por documentación

General

Manual de GitHub

Traducción y localización

Tareas en desarrollo

General

Manual de GitHub

Traducción y localización

Tareas fantasma

General

Manual de GitHub

  • Ninguna tarea abandonada

Traducción y localización

  • Ninguna tarea abandonada

Tareas sin asignar

General

Manual de GitHub

Traducción y localización

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

Reunión del equipo de documentación mayo 14, 2024

Nos reuniremos via Google Meet, puedes bajarlo antes de la reunión a las 17:30 h (hora de Madrid.) El enlace es https://calendar.app.google/FstoVSJ3NzDcec9k9

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

Agenda

  1. Quienes están presentes
  2. Voluntario(a) para tomar notas y subirlas al blog de es.wordpress.org
  3. Avances del proyecto de localización de la documentación
  4. Avances en el Spain Handbook
  5. Sugerencias de trabajo para el contributor day de WCEU
  6. Foro abierto para preguntas, dudas, etc.

Notas de la reunión anterior

Reunión del equipo de documentación mayo 7, 2024

Nos reuniremos via Google Meet, puedes bajarlo antes de la reunión. El enlace es https://calendar.app.google/BBowQuWpw5dT1Dji9

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

Agenda

  1. Quienes están presentes
  2. Voluntario(a) para tomar notas y subirlas al blog de es.wordpress.org
  3. Revisión de las instrucciones para como contribuir a la traducción de la documentación
  4. Revisión de los tickets abiertos para comenzar a traducir
  5. Foro abierto para preguntas, dudas, etc.

Notas de la reunión anterior

Estado de la Documentación 2024-05-02

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

Tareas cerradas

  • Ninguna tarea cerrada

Tareas por publicar

  • Ninguna tarea por publicar

Tareas revisión GTE

  • Ninguna tarea por revisar

Tareas en revisión

Tareas en desarrollo

Tareas fantasma

  • Ninguna tarea fantasma

Tareas prioritarias

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

Estado de la Documentación 2024-04-25

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

Tareas cerradas

Tareas por publicar

  • Ninguna tarea por publicar

Tareas revisión GTE

  • Ninguna tarea por revisar

Tareas en revisión

Tareas en desarrollo

Tareas fantasma

  • Ninguna tarea 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

Estado de la Documentación 2024-04-18

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

Tareas cerradas

  • No hay ninguna tarea cerrada

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 de documentación

Notas de la reunión del equipo de documentación celebrada el día 2024-16-04

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

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

Como punto inicial se han repasado los puntos que deben incluirse en el apartado de accesibilidad del cual se hace responsable @visanju.

Presentación a debate del proyecto realizado en la WordCamp Barcelona 2023

Durante el Contributor Day de la WordCamp Barcelona 2023, se reunieron en un equipo de trabajo varios miembros de los grupos de trabajo de: marketing, documentación y traducción. De esa conjunción de equipos surgió el boceto de un esquema traducido al español de España de las categorías y subcategorías. Durante los próximos días Estela convertirá este proyecto en una hoja editable, Excel o similar, en la que el grupo de documentación y todo el que quiera participar afinará las traducciones para que sean óptimas.

Datos de la documentación a traducir

En el equipo de documentación se ha realizado un esfuerzo para depurar la documentación de forma que sea lo más amigable posible, ya que está dirigida al usuario final. Esta información la ha proporcionado @estelaris.

Eso no impide a petición del equipo de soporte y dentro del grupo de trabajo hace referencia a ello también @nilovelez de la necesidad de incluir el apartado de instalación de WordPress en 5 minutos o instalación básica de WordPress. Se ha aprobado incluir ese apartado dentro de la documentación, ya que resulta un texto básico dentro de la documentación de WordPress, aunque sea para usuarios finales.

Ubicación y estructura de los textos creados En un principio

Las categorías se reparten en 4 grupos con sus sub etiquetas de la siguiente manera:

  • Grupo 1: Descripción general
  • Grupo 2: Guías técnicas
  • Grupo 3: Guías de soporte
  • Grupo 4: Personalización

En un inicio se dejará de forma provisional el nombre de «HelpHub» a todo el proyecto, aunque la idea es cambiar este nombre por uno que siga la guía de estilos del español de España y mantenga sentido con su nombre en inglés.

Los textos se ubicarán en el Spain Handbook, se crearán 4 proyectos, que son los grupos de categorías existentes y que de los cuales se dará prioridad al grupo 1 y 2 para comenzar a traducir, dejando el número 3 y 4 para más adelante, puesto que van a sufrir importantes transformaciones los textos y se opta por esperar esas acciones para traducir los nuevos textos que se creen.

La estructura de la documentación dentro del proyecto seguirá estos pasos:

  • No status: como listado general de issues.
  • In progress: issues en el que se está trabajando.
  • In review: traducción:  el encargado de realizar las revisiones de cumplimiento de la guía de estilo y glosario del español de España.
  • Done:
  • los documentos en esta columna han sido aprobados y están listos para subirse a es.worpress.org (aún no está confirmada la sección de documentación)

Asimismo, se añadirán las etiquetas que en cada caso sean pertinentes para que resulte más fácil el manejo de toda la documentación a lo largo de todo el proceso.

@josepmoran propone que se trabaje en local creando un fork del proyecto de documentación con la finalidad de evitar que se puedan crear problemas en el proyecto principal. Optando así por el sistema que se está utilizando en el Spain Handbook.

Contributor Day de Yoast

@estelaris nos recuerda que el próximo día 18 de abril se celebra este evento e invita a todos los presentes y los que puedan leer este resumen a participar de manera online a cualquiera que pueda participar.

WordCamp for Docs

@estelaris explica que la WordCamp for Docs estará enfocada en documentación. Pese a estar invitados todos los que quieran asistir, aún no se puede dar por hecho el día de celebración, que puede ser el día 18 de octubre del 2024.

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

#documentacion #reuniones #agenda

Reunión del equipo de documentación, 16 de abril 2024

Las reuniones se han cambiado a los martes a las 17:30 h (hora de Madrid) y nos reuniremos via Google Meet, puedes bajarlo antes de la reunión. El enlace es https://calendar.app.google/HnERVZSRQuWqCUhYA

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

Agenda

  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 (si alguien aún tiene dudas)
  4. Revisión de la entrada sobre el sitio de mapa de documentación
  5. Yoast contributor day – Abril 18
  6. Foro abierto para preguntas, dudas, etc

Notas de la reunión anterior

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

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