Bienvenu !

N'hésite pas à poser des questions.

On est aussi joignable sur IRC, par exemple via https://kiwi.freenode.net/, channel #python-docs-fr, tu n'as pas besoin de créer de compte, pas besoin de mot de passe, juste besoin d'être patient car il est possible qu'on ne soit pas les yeux rivés sur le channel à ce moment là. Hésite pas à me mentionner d'ailleurs si tu pose une question (en écrivant mdk: avant ta question), je la verrai mieux.

On organise aussi des ateliers sur Paris : https://www.meetup.com/fr-FR/Python-AFPY-Paris/ si tu es de la région, le prochain c'est jeudi.

@Kydlaw Tu travailles toujours dessus ?

Tu fais bien de me relancer, j'avais avancé jusqu'au départ en vacances et puis ...
Je termine dès que possible!

Hello @Kydlaw . Toujours dessus ? Si non ce n'est pas grave, fais une PR avec ce que tu as déjà, qu'on puisse intégrer ton travail et que d'autres puissent continuer.

Vraiment navré pour l'attente... J'ai complété la traduction. Il me reste certains termes que je ne sais pas vraiment comment traduire (non rentré dans le glossaire). Je veux bien un coup de main là-dessus avant de soumettre la PR. Je les mets à la suite en gras italique:

• Generics can be parameterized by using a new factory available in typing called :class:TypeVar.

• It is possible to declare the return type of a callable without specifying the call signature by substituting a literal ellipsis for the list of arguments in the type hint: Callable[..., ReturnType].
  -> (ellipse littérale ?)

• This behavior allows :data:Any to be used as an escape hatch when you need to mix dynamically and statically typed code.

• :pep:544 allows to solve this problem by allowing users to write the above code without explicit base classes in the class definition, allowing Bucket to be implicitly considered a subtype of both Sized and Iterable[int] by static type checkers. This is known as structural subtyping (or static duck-typing)::
  -> (duck-typing revient très souvent dans ce module, j'osais pas partir sur "typage canard" sans demander)

• This decorator is itself not available at runtime. It is mainly intended to mark classes that are defined in type stub files if an implementation returns an instance of a private class::

• Note that returning instances of private classes is not recommended. It is usually preferable to make such classes public.
  -> (ça me fait bizzare de traduire en "classes privées" ou "classes publiques", j'aimerais avoir votre avis)

• Callable
  -> (que j'ai traduit en Callable directement plutôt qu'appelable)

Pas simple effectivement 😉

Je pense que ça serait une bonne idée d'ensuite les ajouter au glossaire, non ?

Vu que cette page m'intéresse, mes deux centimes (ça n'engage que moi :-)).

* Generics can be parameterized by using a new _**factory**_ available in typing called :class:`TypeVar`.

L'usage Wikipédien est de traduire par fabrique. On peut préciser « fabrique (au sens des patrons de conception) ».

* It is possible to declare the return type of a callable without specifying the call signature by substituting a _**literal ellipsis**_ for the list of arguments in the type hint: `Callable[..., ReturnType]`.
  -> (ellipse littérale ?)

Une ellipse. Je pense que c'est suffisamment clair.

* This behavior allows :data:`Any` to be used as an _**escape hatch**_ when you need to mix dynamically and statically typed code.

Littéralement, une sortie de secours. Plus prosaïquement : une solution.

* :pep:`544` allows to solve this problem by allowing users to write the above code without explicit base classes in the class definition, allowing `Bucket` to be implicitly considered a subtype of both `Sized` and `Iterable[int]` by static type checkers. This is known as _structural subtyping_ (or static _**duck-typing**_)::

Je ne suis pas choqué par typage canard, ça se trouve dans quelques bouquins (même hors Python, en Ruby par exemple).

* This decorator is itself not available at runtime. It is mainly intended to mark classes that are defined in type _**stub**_ files if an implementation returns an instance of a private class::

Ok, ça c'est chaud. « définies dans des fichiers séparés spécifiques » ?

* Note that returning instances of _**private**_ classes is not recommended. It is usually preferable to make such classes _**public**_.
  -> (ça me fait bizzare de traduire en "classes privées" ou "classes publiques", j'aimerais avoir votre avis)

Je ne crois pas que ce soit un problème.

* _**Callable**_
  -> (que j'ai traduit en _Callable_ directement plutôt qu'appelable)

Je suis à peu près certain qu'appelable existe déjà dans la doc française.

Merci pour tes propositions @nshaud !
Si personne n'a d'objections, je fais les modifications ce soir et je soumets la PR pour review.

Ellipsis : il s'agit des points de suspension (« … »). Voir le Glossaire de la documentation
duck-typing : wikipedia traduit effectivement par « typage canard »

christopheNan me coupe l'herbe sous le pied pour « typage canard » : c'est en effet utilisé par la page Wikipédia français, alors go ! Quand à « callable », je confirme que nous l'avons traduit partout par « appelables », le lecteur ne sera donc pas perdu.
Kydlaw, connais-tu pogrep ? C'est un outil fait par JulienPalard pour grep-er un terme anglais dans la traduction et voir dans quelle entrées il apparaît traduit, et donc par quoi il a déjà traduit dans la doc. C'est indispensable !
pip install pogrep puis pogrep <le mot> dans ton clone de python-docs-fr.

@deronnax Non, mais maintenant oui.
C'est effectivement indispensable et vraiment bien fichu. Kudos à JulienPalard du coup.
Il serait vraiment intéressant de le mentionner quelque part dans le README.rst

Vraiment navré pour l'attente...

On a pas de deadlines ici, no stress :)