Material para la charla "python-docs-es" - PyConES, Oct 3-4, 2021
- Contexto
Al momento de realizar una primera contribución a Python, muchas personas que están comenzando (o sienten que no tienen suficiente experiencia) se sienten intimidadas, ya que la asociación directa es 'escribir código avanzado'. Sin embargo, mucha gente olvida que la documentación de los proyectos juega un papel muy importante para el desarrollo y crecimiento de los mismos.
Adicionalmente, si consideramos que el Español es la segunda lengua materna del mundo por número de hablantes[1], lo hace un idioma fundamental para la documentación de una iniciativa tan importante como lo es Python.
- Definición del problema
Hace un año, el Español no era un lenguaje en el cual se presentara la documentación oficial de Python, lo cuál generaba dos problemas principales:
- Las personas que no manejaban bien el inglés no podían acceder directamente a los documentos, y
- los esfuerzos de traducciones estaban fragmentados, y muchas comunidades intentaron solucionar esta situación con traducciones parciales.
- Por qué es importante buscar una solución
Ofrecer la documentación oficial de Python en Español brindará la oportunidad a la comunidad mundial de hispanohablantes de poder acceder directamente a ella, sin necesitar un segundo idioma; pero además creará lazos de identidad en aquellos que se sumen al ejercicio colectivo de explicar y traducir los conceptos de la documentación. Se genera identidad y comunidad. Vos viste: ¡traducir flipa! 😉
- ¿De qué se hablará y qué aprenderán los asistentes?
Compartiré mi experiencia personal, reflejando las experiencias de las casi 200 personas que actualmente participan de este esfuerzo colectivo. Además, podrás aprender el flujo de trabajo con el cual la iniciativa ha tenido un primer año exitoso, reflejado principalmente por ser actualmente un idioma oficialmente aceptado.
- Algún requerimiento previo o comentario adicional.
Sólo necesitas hablar español para poder unirte a la comunidad. Aprenderás las tecnologías necesarias para realizar tu primera contribución a Python y podrás ser parte de un hito importantísimo en la historia de las comunidades hispanohablante de Python.
Participar del proyecto ha sido una experiencia de desarrollo personal genuinamente comunitaria y fuertemente anclada en el crecimiento de Python (Sí, de Python. Así como lo lees 😜). De allí que quiero animar a las personas a sumarse, descubrir, y sorprenderse de todo lo que es posible a través de un lenguaje de programación.
Por otro lado, creo que esta iniciativa rompe barreras de acceso para una gran mayoría que se quiere iniciar en la programación y no domina el inglés: romper esas barreras es una de las motivaciones que me guian. Como acto de amor en devolución a todo lo que he recibido generosamente y fundamentalmente como acto de justicia por aquellos que aún no han tenido las mismas oportunidades.
Brindar la posibilidad de sumarse a un proyecto concreto, de alto impacto y accesible a todas las personas es de un valor inconmensurable.
Espero que puedan descubrir un espacio de colaboración siempre abierto a compartir, crecer y ayudar.
[1] El español, una lengua viva. Informe 2020. Instituto Cervantes. Disponible aquí