[3.12] gh-107305: Update the C-API Docs for PEP 684 (gh-107324)

[3.12] gh-107305: Update the C-API Docs for PEP 684 (gh-107324) #23125