Revamp infra

[rffontenelle]

Este pull request visa mudar a scripts, workflows, etc. para atualização e teste das traduções para português brasileiro.

Vejo os seguintes problemas na solução atual:

• Polui os branches de arquivos de tradução (3.13), pois os scripts são feitos considerando estar em um branch de arquivos de tradução.
• Makefile não é das sintaxes mais amigáveis e o script estava bem longo, dificultando sua manutenção.
• Uso duplicado do pomerge, tendo em vista que a própria infraestrutura de scripts do projeto do Transifex já faz isso.
• requirements.txt contendo requisitos já fornecidos pela documentação do cpython; melhor ter um requirements.txt mais enxuto, e usar o arquivo do cpython (e seu arquivo constraints.txt)
• Arquivo de problem-matcher no repositório, quando poderia-se usar o action específico

A nova solução foi em muito baseada na do time python-docs-zh-cn, e tem as seguintes características:

• Branch main como principal e, portanto, será de onde os workflows do GitHub Actions serão executados.
• Os scripts ficarão no diretório scripts/ e será removido Makefile em favor de Shell e Python (com os quais tenho mais afinidade)
• Cada versão Python terá seu próprio arquivo workflow. Isso permite ter no README um badge para cada versão acusando a situação da construção.
• O README terá a porcentagem de tradução de cada versão usando ./scripts/tx_stats.py.
• Como testar localmente:

PYDOC_VERSION=3.13
PYDOC_TX_PROJECT=python-newest
PYDOC_LANGUAGE=pt_BR
PYDOC_REPO=https://github.com/python/python-docs-pt-br
./scripts/setup.sh      # clona repositórios e instala dependências
./scripts/pull_translations.sh library/os.po   # argumento opcional para baixar um específico
./scripts/build.sh      # usa sphinx-build -b html para levantar erros de sintaxe
./scripts/lint.sh       # usa sphinx-lint

A este pull request seguirá uma limpeza em cada branch de versão, de forma que cada branch de versão tenha apenas:

• arquivos de tradução
• potodo.md (uma lista de traduções incompletas)
• stats.json (o arquivo que conterá a porcentagem de tradução)
• README resumido sobre aquela versão

[vinigfer]

Some suggestions.
Other than that, LGTM

[vinigfer]

This always is really necessary? With the &&, doesn't ends up going back to being just steps.build.outcome == 'failure'?

[rffontenelle]

Weird enough, it is necessary as it wouldn't run otherwise.

[vinigfer]

Maybe we could/should move this logs/sphinxwarnings.txt and logs/notify.txt to environment variables/constants.
Since it's being used on multiple places and different files. That way if we change it, already updates everywhere it's necessary.

[vinigfer]

Maybe an easier to understand name?
How about

Suggested change

	name: python-310
	name: Sync python 3.10 docs

?

Same for the other python-3*.yml files

[rffontenelle]

So far, this is the easiest solution to make easier to copy and paste the Transifex project name across the YAML files. Notice how I used ${{ github.workflow }} as value below; this uses the 'name', which is 'python-310' in this case.

And it seems GitHub actions doesn't allow passing environment variable as input to reusable workflow (i tested it!), e.g.:

env:
  PROJECT='python-310'
  VERSION='3.10'

jobs:
  sync:
    uses: ./.github/workflows/sync.yml
    with:
      tx_project: ${{ env.PROJECT }}
      version: ${{ env.VERSION }}
    secrets: inherit