Production tokens are not clickable

[Arthur-Milchior]

BPO	45640
Nosy	@ambv, @miss-islington, @Arthur-Milchior
PRs	bpo-45640: Tokens are now clickable #29260 [3.10] bpo-45640: [docs] Tokens are now clickable (GH-29260) #29621 [3.9] bpo-45640: [docs] Tokens are now clickable (GH-29260) #29623

^{Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.}

Show more details

GitHub fields:

assignee = None
closed_at = <Date 2021-11-18.18:37:58.083>
created_at = <Date 2021-10-28.03:04:26.553>
labels = ['3.8', '3.9', '3.10', '3.11', '3.7', 'docs']
title = 'Production tokens are not clickable'
updated_at = <Date 2021-11-18.18:37:58.082>
user = 'https://github.com/Arthur-Milchior'

bugs.python.org fields:

activity = <Date 2021-11-18.18:37:58.082>
actor = 'lukasz.langa'
assignee = 'docs@python'
closed = True
closed_date = <Date 2021-11-18.18:37:58.083>
closer = 'lukasz.langa'
components = ['Documentation']
creation = <Date 2021-10-28.03:04:26.553>
creator = 'Arthur-Milchior'
dependencies = []
files = []
hgrepos = []
issue_num = 45640
keywords = ['patch']
message_count = 4.0
messages = ['405147', '406546', '406554', '406559']
nosy_count = 4.0
nosy_names = ['docs@python', 'lukasz.langa', 'miss-islington', 'Arthur-Milchior']
pr_nums = ['29260', '29621', '29623']
priority = 'normal'
resolution = 'fixed'
stage = 'resolved'
status = 'closed'
superseder = None
type = None
url = 'https://bugs.python.org/issue45640'
versions = ['Python 3.6', 'Python 3.7', 'Python 3.8', 'Python 3.9', 'Python 3.10', 'Python 3.11']

[Arthur-Milchior]

In the current documentation, production tokens are not clickable. For example in https://docs.python.org/3/reference/expressions.html#yield-expressions , you highlight `yield_from` as a token but do not link to it.
I suppose that the goal, when using :token:`yeld_from`, was to ensure that the token links to its definition. However, Sphinx require to use :token:`~python-grammar:yeld_from` for the link to appear.

I suggest adding ~python-grammar after each token:.