Do you speek English?

Es común tener días en los que la inspiración le alcanza a un programador para escribir cientos de líneas de código sin que escriba un solo comentario. Sin embargo, pasado un tiempo, en ausencia de la documentación, y con un vago recuerdo de la lógica aplicada al diseño del algoritmo, muchos de los métodos se le harán indescifrables, y tendrá que aplicar esfuerzo y tiempo en tratar de entender el código que él mismo produjo. Documentar conscientemente hoy hará más fácil el proceso de depuración mañana.

No hay duda que publicar un código documentado facilita a cualquier ayuda potencial capitalizar su trabajo, pero si el proyecto esta escrito en español tan solo podrá ser mantenido por personas que hablen o entiendan español. Esta decisión de diseño impondría un límite al número de desarrolladores disponibles para trabajar en él, porque lo más probable es que un programador de Polonia, Rusia, Alemania, Japón o China no esté familiarizado ni de lejos con la lengua de Cervantes, pero por el contrario existe una alta probabilidad de que tenga un uso funcional de la lengua de Turing. Para muchos programadores y desarrolladores -y me incluyo en la lista- la lengua en la que se comunica la comunidad hacker es el inglés.

Teniendo en cuenta esta realidad, se hace obvia la importancia de documentar en inglés el código, de crear funciones con nombres descriptivos en inglés, y de aplicar las recomendaciones de WordPress para gettext usando como idioma base un inglés funcional. Esto abrirá la posibilidad de recibir ayuda de casi cualquier programador en el mundo, para un desarrollo que podrá ser usado por cualquier persona que hable un inglés funcional, y que además facilitaría los medios para ser traducido a otro idioma. Si después de varias versiones se decide cambiar un texto en inglés dentro de la interfaz, se podrá crear un archivo de lenguaje para el idioma por defecto y aplicar el cambio sin tener que cambiar el código fuente y todos los archivos descriptores en otros idiomas.

¿Por qué usar las salidas de texto en inglés funcional y no en nuestro propio idioma? Porque si el desarrollo se instala en un entorno con un código i18n que no está en la lista de archivos de lenguajes que ya hayamos creado, entonces se visualizará en nuestro propio idioma, lo que dificultará muy seguramente que alguien de Japón, Rusia o Grecia lo pueda usar. Recuerde que es más probable que sepan inglés a que sepan español.

Regla de la documentación: deja constancia de todo paso que des
y del por qué lo estás dando.

Regla del idioma común: el idioma de la comunidad hacker es el inglés.

Regla de la internacionalización (i18n): aplica los macros gettext en todas las
salidas de texto, y usa como base un inglés funcional.

Capí­tulos: | Anterior | Prefacio | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | Siguiente |