Development #51277
doc: add instructions for developers to update translations
0%
Description
Tout dans le titre ;-)
Fichiers
Révisions associées
Historique
Mis à jour par Loïc Dachary il y a environ 3 ans
Mis à jour par Frédéric Péters il y a environ 3 ans
Ça donne l'idée bizarre qu'il faut contribuer des .po actualisés mais ne contenant pas les nouvelles traductions.
Mis à jour par Loïc Dachary il y a environ 3 ans
L'autre possibilité est de ne pas actualiser les .po avec les nouvelles chaines du tout. Mais c'est prendre le risque qu'une erreur du genre `_("foo {bar}".format(bar=1))` au lieu `_("foo {bar}").format(bar=1)` de passe inaperçue. Alors qu'elle se voit assez bien dans le diff du .po au moment du review, ce qui me motive a mettre à jour les .po histoire d'éviter ce genre d'accident.
Ceci dit c'est juste mon avis et si la consigne est plutôt de ne jamais le faire, ça me va aussi: moins de travail pour le contributeur je suis pas contre :-)
Mis à jour par Loïc Dachary il y a environ 3 ans
Je voulais dire
au moment de la revue de code
et non pas
au moment de la review
Mis à jour par Frédéric Péters il y a environ 3 ans
Pas de modif au .po dans les patchs; ça rend tout travail de merge/cherry-picking/rebase/etc. pénible.
Mis à jour par Loïc Dachary il y a environ 3 ans
- Fichier 0001-doc-add-instructions-for-developers-to-update-transl.patch 0001-doc-add-instructions-for-developers-to-update-transl.patch ajouté
J'ai mis à jour pour expliquer que cette mise à jour des po as seulement un intérêt pour vérifier de possibles erreurs localement mais ne doit pas être incluse dans un patch. Est-ce que ça va comme ça ?
Mis à jour par Valentin Deniaud il y a presque 3 ans
- Assigné à mis à Loïc Dachary
Je ne pense pas que ce soit la place du README de donner ce genre de petit conseil (qui en plus sous-entendrait que le relecteur fait mal son boulot !), il faut s'en tenir à l'essentiel pour cette section : les traductions ne sont pas mises à jour avec les patches, c'est fait à part.
Mis à jour par Loïc Dachary il y a presque 3 ans
Je ne pense pas que ce soit la place du README ...
Je pense qu'il y a une confusion: il s'agit de la section développement de la documentation d'Authentic et non du README (ce serait un peu superflu dans un README, en effet).
Mis à jour par Loïc Dachary il y a presque 3 ans
L'objet de cette section est double:
- Documenter la façon dont il est possible de mettre à jour les traductions (ce n'est pas trivial)
- Préciser que c'est fait ailleurs
Si cette section se contentait de mentionner que les traductions sont mises à jour ailleurs, sans préciser comment techniquement, cela ferait défaut à une personne qui voudrait faire elle même les traductions, quelque soient ses motifs. C'est une information utile, qui se trouve dans le bon contexte et qu'on ne trouve pas ailleurs.
Mis à jour par Frédéric Péters il y a presque 3 ans
Documenter la façon dont il est possible de mettre à jour les traductions (ce n'est pas trivial)
Et les instructions dans le patch ne sont pas correctes.
Il ne fonctionne peut-être plus, ou est lourdingue, mais il y a update-locales.sh ajouté là :
commit e0071fb470536ce0f38f576d7cd75191e99ed924 Author: Benjamin Dauvergne <bdauvergne@entrouvert.com> Date: Sat Jun 22 16:03:35 2019 +0200 add script to update locales
Mis à jour par Loïc Dachary il y a presque 3 ans
- Fichier 0001-doc-add-instructions-for-developers-to-update-transl.patch 0001-doc-add-instructions-for-developers-to-update-transl.patch ajouté
Je n'avais pas vu ce script: il fonctionne encore et il est plus simple que ce que j'avais trouvé. Une raison de plus pour l'inclure dans la documentation afin d'éviter à un·e autre développeur·euse de s'égarer comme je l'ai fait :-) Voici un patch révisé pour faire référence à update-locales.sh
Mis à jour par Valentin Deniaud il y a presque 3 ans
Je verrais bien une réorganisation de la section pour dire d'abord qu'il ne faut pas commiter de trad, et ensuite pointer la commande pour au cas où, tout en enlevant le bout qui raconte que c'est « useful to check for mistakes ».
Mis à jour par Loïc Dachary il y a presque 3 ans
- Fichier 0001-doc-add-instructions-for-developers-to-update-transl.patch 0001-doc-add-instructions-for-developers-to-update-transl.patch ajouté
C'est fait.
Mis à jour par Valentin Deniaud il y a presque 3 ans
- Statut changé de Nouveau à Solution validée
Mis à jour par Valentin Deniaud il y a presque 3 ans
- Statut changé de Solution validée à Résolu (à déployer)
commit 4fca92f5473b11ac0c15acc9cdbdb807caba1e17 Author: Loïc Dachary <ldachary@easter-eggs.com> Date: Tue May 4 13:12:57 2021 +0200 doc: add instructions for developers to update translations (#51277) License: MIT
Mis à jour par Frédéric Péters il y a presque 3 ans
- Statut changé de Résolu (à déployer) à Solution déployée
doc: add instructions for developers to update translations (#51277)
License: MIT