search

Qwik-Spanish / qwik-i18n-translate-es

Spanish Translation documentation from Official Qwik Documentation
MIT License
2 stars 3 forks source link

readme

qwik-i18n-translate-es

Spanish Translation documentation from Official Qwik Documentation

Guía de contribución

Únete al canal en español de Discord Builder.io/Qwik en donde podrás compartirnos tus ideas.

Envío de Pull Requests

  1. Busca una tarea pendiente, ábrela y solicita que se te asigne. Proyecto Qwik ES. Debes etiquetar a @mugan86, @manuelsanchez2 o @leifermendez.
  2. Una vez asignada, haz un Fork del repositorio en tu propia cuenta.
  3. Dirígete a branches, presiona en New branch (crear branch) con las siguientes configuraciones:
  4. Clona el repositorio bifurcado en tu equipo de forma local y dirígete a la branch correspondiente a tu tarea:
    • git clone <URL>
    • cd qwik-i18n-translate-es/
    • git branch -a para ver las branches disponibles.
    • git checkout docs/00-nombre-seccion
  5. Abre los archivos index.mdx de cada subsección para que puedas traducirlos (p. ej. cd \(qwik\)/seccion/subseccion/index.mdx)
  6. Para la traducción, actualmente estamos utilizando el siguiente prompt y pasándolo a ChatGPT:
    • Prompt Qwik ES
    • Luego de utilizar el prompt, traducir el texto por partes puede ser conveniente para no saturar el servicio.
    • Utiliza esta frase para cada parte que se le pase al chat: "Traduce esto con i18nIT por favor: ...pegar parte del texto..."
  7. La traducción la realizará la IA y nuestra responsabilidad recae en revisar las traducciones.
  8. Se deben realizar correcciones de acuerdo con los términos importantes en el siguiente Glosario Qwik ES:
    • Se deben anotar aquellos que aún no están y que se consideren importantes. (En cada subsección pueden haber términos específicos, es necesario anotarlos).
    • Se ha convenido que los términos en inglés deben tener preferencia por sobre las traducciones al español, siempre que sea posible, porque facilitan buscar información.
    • Revisar la términología, la puntuación y la coherencia del texto. Lo fundamental de realizar traducciones es que sea fácil de entender por el lector (legibilidad).
  9. Realiza un commit con un mensaje que incluya el nombre de la sección, puedes revisar commits anteriores para tener una referencia. Se recomienda utilizar "Commitizen".
  10. Haz push de tu rama a GitHub: git push origin docs/00-nombre-seccion.
  11. En GitHub, envía la Pull Request (PR) al repositorio principal Qwik-Spanish/qwik-i18n-translate-es/.
  12. Puedes solicitar revisión y una vez que la branch sea aprobada se incluirá (merge) en la principal (main).

Flujo simple

flowchart TB
    A(Solicitar asignación de tarea) -->|asignada| B{Forkeado?}
    B -->|SÍ| D(Clonar branch)
    B -->|NO| C(Forkear repo)
    C --> D(Clonar branch)
    D -->|clonada| E(Clonar repo en local)
    E -->|cambiar a branch de tarea| F(Traducir Archivos\nChatGPT + Glosario)
    F -->|Commit + Push| G(Enviar Pull Request)