Automatização da documentação traduzida do Python

As traduções publicadas da documentação do Python não eram atualizadas automaticamente, exigindo que alguém o fizesse manualmente. Veja como usamos integração contínua para automatizar a atualização das traduções publicadas e, de quebra, implementar outras verificações.

-------

Automation of translated Python documentation

Published translations of Python documentation were not being updated automatically, requiring someone to do it manually. See how we used continuous integration to automate the updating of publications and implement other checks.

Transcript

1. Rafael Fontenelle Automatização da documentação traduzida do Python Automatização da documentação traduzida do Python
2. Agenda • História • Problemas • Como resolvemos • Ideias de melhorias
3. História • Traduções não oficiais
4. História • PEP 545 (https://www.python.org/dev/peps/pep-0545/)
5. História • Transifex (https://www.transifex.com/python-doc/public)
6. Problemas • As traduções contribuídas não eram automaticamente publicadas em docs.python.org • Sem tratamento de erros de sintaxe ReStructuredText
7. Problemas
8. Como resolvemos • Makefile com comandos-chaves
9. Como resolvemos • E com workflow do GitHub Actions
10. Como resolvemos • Execuções diárias (agendadas) • Pull de traduções do Transifex • Push para o repositório python-docs-pt-br • Notificação em caso de erro • Logs acusando o erro exato
11. Como resolvemos • i17obot (https://github.com/rougeth/i17obot)
12. Ideias de melhorias • Rescrever o Makefile em Python https://t.me/pybr_i18n https://github.com/python/python-docs-pt-br
13. Ideias de melhorias • Rescrever o Makefile em Python • Tornar o script executável em outros SO além do Linux https://t.me/pybr_i18n https://github.com/python/python-docs-pt-br
14. Ideias de melhorias • Rescrever o Makefile em Python • Tornar o script executável em outros SO além do Linux • Melhorar notificação (logs acessíveis fora do GitHub) https://t.me/pybr_i18n https://github.com/python/python-docs-pt-br
15. Ideias de melhorias • Rescrever o Makefile em Python • Tornar o script executável em outros SO além do Linux • Melhorar notificação (logs acessíveis fora do GitHub) • Simplificar workflow do GitHub Actions https://t.me/pybr_i18n https://github.com/python/python-docs-pt-br
16. Perguntas? Rafael Fontenelle Twitter: @rafaelffbr1 Telegram: @rafaelff1