Ahora mismo casi todo en la página de wollok está tanto en español como inglés.
Sin embargo, la guía completa del lenguage está solo en inglés y eso es porque se autogenera a partir de los archivos .wlk de acá que tienen comentarios en inglés. El script que entre otras cosas se encarga de eso es este y lo hace usando el código de esta clase
¿Cómo podríamos hacer para tener esa documentación tanto en inglés como en español y cómo se podría evitar que quede desactualizada?
Las opciones que se me ocurrieron por ahora son:
No autogenerar la documentación en español y escribirla a mano a partir de la otra. Es lejos lo más simple que se me ocurre. Se podría modificar un poco el script como para que haya forma de saber cuando la documentación en español puede haber quedado desactualizada.
Que los comentarios de wollok puedan tener alguna forma de localización dentro del mismo comentario, esto podría servir para generar ambas documentaciones. Pero si hay herramienetas del IDE que hagan algo con esos comentarios al principio serían agnósticas de esto, eso sería un problema? me imagino que podría ser molesto tratar de ver la documentación de un método y que te salga un montón de texto por tener tanto la versión en español como en inglés y por tener que ser facil de parsear, y si fuese algún tipo de markdown?
Que se traduzcan automáticamente las cosas usando algun servicio, pero está el riesgo de que traduzca cualquier cosa (?
No se, que les parece mejor, o tienen alguna idea superadora? 🤔
Ahora mismo casi todo en la página de wollok está tanto en español como inglés.
Sin embargo, la guía completa del lenguage está solo en inglés y eso es porque se autogenera a partir de los archivos .wlk de acá que tienen comentarios en inglés. El script que entre otras cosas se encarga de eso es este y lo hace usando el código de esta clase
¿Cómo podríamos hacer para tener esa documentación tanto en inglés como en español y cómo se podría evitar que quede desactualizada? Las opciones que se me ocurrieron por ahora son:
No se, que les parece mejor, o tienen alguna idea superadora? 🤔