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

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