Como colaborar

Configuración inicial

1. Instálate el repositorio en local y hazlo funcionar:

   1. Asegúrate de tener Ruby instalado; necesitas la versión 2.4.3 o superior:
      ruby --version

   2. Asegúrate de tener Bundler instalado; si no se instala así:
      gem install bundler

   3. Instala todas las dependencias:
      bundle install

   • En macOS, si encuentra errores mientras se contruyen las extensiones nativas de Ruby, vea Instalación de Nokogiri para consejos sobre solución de problemas.
   • En windows si encuentra problemas recomendamos hacer la instalación desde la consola de ubuntu integrada.

2. Instala la herramienta para servir localmente (configurar solo una vez)
   npm install -g superstatic

3. (Opcional) Si planeas hacer deploy a un proyecto firebase, instala este paquete (configurar solo una vez)
   npm install -g firebase-tools

4. Solicita ser colaborador (ver como en Wiki Home)

Como traducir

1. Echa un vistazo al progreso del trabajo en https://github.com/flutter-es/website/milestones

2. Elige un issue que no esté asignado y asígnatelo, el título del issue refleja la ubicación del archivo en inglés

3. Actualiza tu rama master git pull (estando en la rama master).

4. Crea una rama con el nombre del issue sustituyendo las '/' por '_', por ejemplo git branch widgets_styling

5. Ubícate (sino lo estás) en la rama recién creada.

6. Si has cogido un issue marcado con la etiqueta traducción, copia el fichero que vas a traducir dentro de la carpeta es_ES, incluido la carpeta si no está en el ráiz. (En algunos casos también tendrán assets que copiar). Si has cogido un issue marcado con la etiqueta corrección se tratará de un fichero que ya existe en la carpeta es_ES.

7. Haz las modificaciones en el fichero anterior , siempre dentro de la rama creada.

8. Haz git commit -a -m “traducción de nombre_de_la_rama ...”.

9. Prueba tus cambios ejecutando el sitio localmente, (comprueba también el responsive) Ejecuta solo uno de estos comandos:
   

   • tool/serve.sh
   • bundle exec jekyll serve --incremental --watch --livereload --port 4002

10. Antes de darla por terminada, ejecuta el la validación de enlaces:
    rake checklinks

11. Haz git push origin nombre_de_la_rama para subir la rama con los cambios al repositorio.

12. Crea un pull request aquí, eligiendo en compare: la rama que acabas de subir , agrega en la descripción del mismo close #333 (donde 333 es el numero asignado al issue), asegúrate que estas en flutter-es/website y no en flutter/website

13. Agrega el pull request al proyecto "Proyecto de traducción de flutter"

14. Solicita revisión al resto de colaboradores para que les llegue una notificación, durante la revisión te pueden solicitar correcciones, haz commits nuevos sobre la misma rama y súbelos al repositorio para corregirlas.

15. Cuando al menos 2 colaboradores hayan aceptado los cambios, se podrá hacer merge a la rama master e integrar la traducción.

16. Borra la rama en creada en github una vez realizado el merge.

Transcurridos unos 10 o 15 minutos Travis CI hará su magia y los cambios aparecerán publicados en nuestra web

IMPORTANTE: nunca incluyas en tu rama más ficheros que los necesarios para traducir el issue elegido, tampoco hagas merge de la rama master a tu rama. Si por algún motivo tu PR da un error de build de Travis CI coméntalos por nuestros canales de la comunidad para ver que ocurre.

Flutter-es

Como revisar

1. Solicita ser colaborador (ver como en Wiki Home)

2. Pasaté por nuestros Pull Request y revisa la traducción que quieras en busca de errores ortográficos o para dar una versión mas ajustada de la misma.