Projet

Général

Profil

Development #51277

doc: add instructions for developers to update translations

Ajouté par Loïc Dachary il y a environ 3 ans. Mis à jour il y a presque 3 ans.

Statut:
Fermé
Priorité:
Normal
Assigné à:
Catégorie:
Documentation
Version cible:
-
Début:
19 février 2021
Echéance:
% réalisé:

0%

Temps estimé:
Patch proposed:
Non
Planning:
Non

Description

Tout dans le titre ;-)


Fichiers

Révisions associées

Révision 4fca92f5 (diff)
Ajouté par Loïc Dachary il y a presque 3 ans

doc: add instructions for developers to update translations (#51277)

License: MIT

Historique

#2

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.

#3

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 :-)

#4

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

#5

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.

#6

Mis à jour par Loïc Dachary il y a environ 3 ans

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 ?

#7

Mis à jour par Loïc Dachary il y a environ 3 ans

as seulement

doit se lire

a seulement

#8

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.

#9

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).

#10

Mis à jour par Valentin Deniaud il y a presque 3 ans

Je maintiens tout de même ma remarque.

#11

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.

#12

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
#13

Mis à jour par Loïc Dachary il y a presque 3 ans

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

#14

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 ».

#16

Mis à jour par Valentin Deniaud il y a presque 3 ans

  • Statut changé de Nouveau à Solution validée
#17

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
#18

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

Formats disponibles : Atom PDF