Spanish Translation documentation from Official Qwik Documentation
Únete al canal en español de Discord Builder.io/Qwik en donde podrás compartirnos tus ideas.
- Busca una tarea pendiente, ábrela y solicita que se te asigne. Proyecto Qwik ES. Debes etiquetar a @mugan86, @manuelsanchez2 o @leifermendez.
- Una vez asignada, haz un Fork del repositorio en tu propia cuenta.
- Dirígete a branches, presiona en New branch (crear branch) con las siguientes configuraciones:
- Branch source: Qwik-Spanish/qwik-i18n-translate-es/
- Branch: tu tarea (p. ej. docs/00-nombre-seccion)
- 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 -apara ver las branches disponibles.git checkout docs/00-nombre-seccion
- Abre los archivos index.mdx de cada subsección para que puedas traducirlos (p. ej.
cd \(qwik\)/seccion/subseccion/index.mdx) - 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..."
- La traducción la realizará la IA y nuestra responsabilidad recae en revisar las traducciones.
- 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).
- 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".
- Haz push de tu rama a GitHub:
git push origin docs/00-nombre-seccion. - En GitHub, envía la Pull Request (PR) al repositorio principal Qwik-Spanish/qwik-i18n-translate-es/.
- Puedes solicitar revisión y una vez que la branch sea aprobada se incluirá (merge) en la principal (main).
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)