I like semi-automatically generated docs like AWS API docs that contains in minimum the type information for every field there is, and often much more.
I don't like Python docs where it ends up on long winded explanation for specific cases but does not cover all arguments, or only mention some in passing.