Hate to be that guy, but your first example is not that frustrating to me. I liked the 2 sentences per parameter, and the line breaks between them. I don't li

Hate to be that guy, but your first example is not that frustrating to me. I liked the 2 sentences per parameter, and the line breaks between them. I don't like the general python idiom of "these parameters are for someone else" where they just pass you off to the ssl module documentation. I understand why they do that, they probably just pass them over in code. The Rust community is better here, they take responsibility for every parameter and type input, both for documentation and for backwards compatibility.