Empecemos! #3
Description
Primero gracias a todos los que mostraron su interés en la traducción de los docs de react.js a español!!
La traducción la realizaremos sobre la rama es-docs, pueden hacer push directamente al repositorio, ya que cada uno va a trabajar sobre un archivo independiente no deberíamos tener conflictos. Dejaremos la rama master libre para poder bajar cambios del repositorio principal de reactjs, la idea es que al finalizar la traducción hagamos un rebase sobre master para capturar cualquier cambio en los docs que venga del repositorio principal, mezclar todos los commits de traducción en uno solo y enviar el PR a reactjs
¿Donde empezar?
Los archivos que necesitamos traducir y que representan todo el trabajo que tendríamos que hacer se encuentran aquí.
Podemos observar un ejemplo de traducción aquí, gracias a @ghondar por esto.
Como pueden ver cada archivo a traducir presenta unos campos principales al inicio del archivo, el escribir correctamente esta sección es uno de los puntos más importantes en la traducción.
id -> id original + -es-ES
title -> El titulo original traducido al español
permalink -> link original + es-ES.html
next -> el siguiente link original + es-ES.html
Aclaramos que necesitamos tanto personas que traduzcan y otras personas que revisen la calidad de la traducción, si te interesa ser traductor o revisador (o los dos) porfavor coméntalo.
¿Como visualizar los docs en nuestra maquina local?
Los developers de facebook tienen una excelente guía aquí, he comprobado que la guía funciona perfecto en OSX (con alguna excepción que nuestro amigo @ghondar nos aclara aquí), en windows alguien de nuestros colaboradores tendría que contarnos su experiencia a la hora de tratar de levantar los docs.
PD: Si por algún motivo no quieren/no pueden bajar ruby ni ninguna otra dependencia, o darse el trabajo de setear este ambiente, pueden usar soluciones online como http://dillinger.io para visualizar el contenido de sus traducciones, la desventaja esta en que no podrán visualizar el resultado final en la web de los docs.
¿Que archivos me corresponde traducir?
Bien, hasta el momento son un total de 46 archivos por traducir, el problema es que cada archivo tiene su propia complejidad, algunos tienen mas contenido que otro así que sería buena idea que midamos la complejidad de cada archivo (por cantidad de palabras o lineas) y en base a eso poder hacer un mejor repartimiento de tareas.
Lista de términos frecuentes en las traducciones
Para una lista de términos que frecuentemente encontramos en las documentación y su correspondiente traducción ver aquí
Futuros planes terminada la traducción
Claramente los docs van a necesitar de mantenimiento y que los actualicemos acorde el avance del repositorio principal.
Para evitar la verificación manual sobre si existe algo que haya cambiado en los docs principales, he pensado que podemos setear un bot que diariamente compruebe los docs del repo de reactjs y de encontrar diferencias en nuestra ultima version que automaticamente abra un issue para nuestra revision.
En fin, empecemos con este esfuerzo de comunidad, estoy seguro que podemos lograrlo!! 🎉 🎈 cc @reactjs-hispano/reactjs-es-docs