homepage

After the section describing roles that create cross-references to C-language constructs, the Dev Guide says this, "The following roles don’t do anything special except formatting the text in a different style."
http://hg.python.org/devguide/file/f518f23d06d5/documenting.rst#l984
However, some of the roles following in that section do do special things other than formatting. For example--
envvar
 An environment variable. Index entries are generated.
keyword
 The name of a Python keyword. Using this role will generate a link to the documentation of the keyword....
 
The description should be changed, or better yet, the roles that do something special should be moved to a different section.

I would like to submit a patch for this. Is anyone currently working on one?

There are no versions for the devguide. There is another misplaced role:
:
option
 A command-line option of Python. The leading hyphen(s) must be included. If a matching cmdoption directive exists, it is linked to. For options of other programs or scripts, use simple ``code`` markup.
I think "The following role does possibly create a cross-reference, but does not refer to objects:" should be changed to something like "The following roles do not refer to module objects, but possibly create cross-references or internal links:". Move the three misplaced roles here, along with token and term.

I moved the 3 misplaced roles (envvar, keyword, and option) and changed the description for the new section per Terry's suggestions. Patch is attached and needs to go in the devguide repo.
https://docs.python.org/devguide/docquality.html#helping-with-the-developers-guide 

New changeset bef3ddfe5d09 by Georg Brandl in branch 'default':
Closes #15569: some roles do create more than formatting
https://hg.python.org/devguide/rev/bef3ddfe5d09 

Thanks!