[3.13] gh-141004: Document built-in iterator types in the C API (GH-141006)

[3.13] gh-141004: Document built-in iterator types in the C API (GH-141006) #215803