[3.14] Docs: Improve the C API documentation involving threads (GH-145520)

[3.14] Docs: Improve the C API documentation involving threads (GH-145520) #9219