If Python's documentation is a "problem", then IMO the devs should continue doing problematic things. What in particular do you find lacking about the documentation? I've never heard this complaint before.