Instruções de instalação do guia de testes estão desatualizadas

[jonesmartins]

As instruções de teste no guia de testes se referem a comandos make de um Makefile que não existe mais.

Pelo que li nos arquivos de CI, hoje usam-se scripts em Bash.
Seria interessante ter instruções referentes à GitHub Action do arquivo check.yml localmente, por exemplo.
Um problema é que qualquer mudança no arquivo check.yml requereria mudanças nas instruções do repositório, e vice-versa.

Uma alternativa seria incluir o programa act como parte das instruções de execução local do CI, porém nunca testei esse programa para saber as desvantagens de usá-lo.

[adorilson]

Eu vim abrir essa issue, mas vi que já estava aberta. :)

[rffontenelle]

@jonesmartins @adorilson Favor conferir novamente o guia de teste. Sugestões são bem-vindas.

[adorilson]

Eu me perdi no passo

./scripts/setup.sh

Porque não é dito anteriormente que deveria ter sido feito o clone do repositório.

Mas depois que fiz entrei para diretorio certo (já tinha o clone, na verdade), deu certo a geração e a execução de todos os outros scripts.

Acho que esse passo do clone + entrar para o diretório deve ser feito antes da criação do ambiente virtual, que aí já resolve outra coisa que me incomoda: venv e .env no home do usuário e não no diretório de trabalho.

ps: tenho outras observações para tornar isso mais simples, penso eu. Mas vamos primeiro fazer e depois melhoramos. :)

[rffontenelle]

@adorilson Alterei o ambiente virtual para ter a criação e ativação num só tópico, e mudei o diretório de ~/venv para .venv no diretório atual. Logo antes do ambiente virtual, adicionei instruções de git clone e também de cd para dentro do diretório. Então, após o 'cd', tanto o .venv quanto a criação do .env para as variáveis estarão dentro do diretório do clone do repositório python-docs-pt-br. Veja o que acha.

[rffontenelle]

Alguma sugestão de melhoria nesta documentação?

[adorilson]

Alguma sugestão de melhoria nesta documentação?

Eu até tenho umas mais estruturais, mas pode ser outra issue.

Para essa, uma dúvida: em que passo será usado o CLI do TX e o token? Talvez isso possa ser pra depois, a depender de quando será usada.

[rffontenelle]

Para essa, uma dúvida: em que passo será usado o CLI do TX e o token? Talvez isso possa ser pra depois, a depender de quando será usada.

Adicionei explicação à seção sobre instalação da ferramenta de cli do Transifex. Veja isso se responde.

[adorilson]

Responde. 😃

E aí acho que dá pra fechar o ciclo colocando o lembrete na seção dos scripts que é necessário ter essas ferramentas, se a pessoa pulou, então tem que voltar lá e fazer.

[rffontenelle]

Concordo. Adicionada nota às seções do script generate_templates.sh e do pull_translations.sh

[adorilson]

LGTM.