I think you may have misread the documentation. It says:

"an OS-level handle to an open file"

which is what you call a file descriptor. Not a file object, which is what you get by calling the builtin `open`, but a file handle like you get from calling `os.open` (as stated).

So I believe that the documentation is correct, but given that at least one person misunderstood it, perhaps it could do with improvement.

Do you have any suggestion for improvement?