python / python/python-docs-pt-br

Melhorar mensagem enviada para Telegram com erro encontrado em arquivo .po pelo linter

Ouverte
#294 1 commentaire 0 réactions 0 personnes assignées Voir sur GitHub

Personne n'a encore pris cette issue.

Langage dominant
Python
Étoiles
164
Forks
42
Merge moyen
14 h 32 min
PR mergées (30 j)
4

Description

Atualmente, quando o linter encontra um erro no .po, é enviada uma mensagem para o Telegram semelhante a essa

Image

O problema disso é que a linha 1280, deste exemplo, do arquivo não é encontrável pelo Transifex.

Então, seria útil que nessa mensagem viesse a URL para a linha no repositório. No caso, seria

https://github.com/python/python-docs-pt-br/blob/3.14/library/string.po#L1280

Ou com o link permanente:

https://github.com/python/python-docs-pt-br/blob/3dfcdb8c00c002f8667d7478a4aa1625fc9eea1d/library/string.po#L1280

Adicionalmente, talvez ficasse mais claro se a mensagem/link fosse para a linha com a msgstr e não a msgid. E talvez com mais algum texto explicativo.

Adicionalmente 2, enviar um URL para pesquisar no TX por uma strings com o texto da string alvo. Para o exemplo seria:

https://app.transifex.com/python-doc/python-newest/translate/#pt_BR/library--string/592013921?q=text%3A'%3E%3E%3E%20\'{0}%2C%20{1}%2C%20{2}\'.format(\'a\'%2C%20\'b\'%2C%20\'c\')'

Note que foi necessário remover o \n da URL.

Guide de contribution

Aucun guide de contribution indexé pour ce dépôt

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Piste de recherche

Repérez le code qui formate les notifications Telegram pour les erreurs du linter dans les fichiers .po, puis examinez comment le fichier et la ligne signalés sont disponibles. Le travail est terminé lorsque le message contient un lien vers la ligne pertinente du dépôt, de préférence vers msgstr, et fournit une URL de recherche Transifex pour la chaîne cible.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Évaluation

Stack technique
python
Domaine
documentation, localization
Type d'issue
Fonctionnalité
Difficulté
3/5
Temps estimé
1-2 jours
Activité
Calme
Clarté
Plutôt claire
Accessibilité débutants
52/100

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.