Effectivement, cela a été corrigé au moins en Python 3.8. Il faudrait backporter la traduction.

@christopheNan c'est corrigé par la PR #1237 que tu as faite, j'imagine qu'on va pouvoir clore cette issue. (Beau boulot au passage !)

Là : https://github.com/python/python-docs-fr/pull/1237/files#diff-11459c2a4864f59367dae8fdfa32fa5bL1671 (oups, le lien ne fonctionne pas, mais la correction est là 😉)

L'apostrophe est pas bon, également.

Bonne vue ! Peux-tu ouvrir un ticket car il est probable que l'on ait des "apostrophe + backtick" ailleurs.

pourquoi on en aurait ailleurs ?

j'ai été dans la branche 3.6 et je ne retrouve pas l'erreur :

"Donne l'élément suivant d'*iterator* en appelant sa méthode :meth:`~iterator."

Par ailleurs, l'erreur est bien dans la doc html (sur docs.python.org) de la 3.6 mais pas de la 3.8. Au fait, ça n'est pas un apostrophe + backtick mais un U+201D Right Double Quotation Mark Unicode Character.
(me demandez pas comment il a atterri là)

Sphinx considère que les apostrophes avant un caractère spécial sont des guillemets anglais. Il faut mettre une séquence d'échappement (que je n'ai plus en tête). Tu peux voir la confirmation avec ces recherches :

  $ pip install pogrep  # thxs Julien
  $ pogrep --fixed-strings --translation --no-source --recursive --line-number  "'*"
  $ pogrep --fixed-strings --translation --no-source --recursive --line-number  "'\`" 

C'est bien une façon d'interpréter de Sphinx, avec ou sans smarquotes. Dans la 3.6 (avec smartquotes), il transforme l'apostrophe (single quote en anglais) en guillemet anglais (double quote). Dans les suivantes (smartquotes désactivés), l'apostrophe est laissée telle quelle.
Je pense que cela ne vaut pas la peine de modifier la 3.6. Ou alors, c'est juste pour désactiver les smartquotes et cela a des effets de bords ailleurs (voir le lien ci-dessus).
Si tu es vraiment puriste (@awecx reveille-toi), tu peux transformer toutes les apostrophes « single quote » en apostrophe typographique (« ´ »). Tu feras ainsi plaisir aussi à Grammalecte.

Et l'issue qui donne les références pour lesquelles les smartquotes ont été désactivés.

Corrigé via #1237

Si tu es vraiment puriste (@awecx reveille-toi), tu peux transformer toutes les apostrophes « single quote » en apostrophe typographique (« ´ »).

Voilà avec, bien entendu, des espaces fines insécables (U+202E) après les guillemets ouvrant et avant les fermant.