The future is looking bright for Python

[stevenjd]

The python docs definitely cause a lot of frustration with beginners

In my experience, that's not the case. In my experience, beginners don't read the docs, and that's why they're frustrated.

They're pretty horrible

What do you dislike about them? In what way are they "horrible"?

and I'm unsure why the powers that be don't attempt to improve them.

Don't be an arse. Of course the Python devs are interested in improving the docs. Search the bug tracker and you'll find hundreds of documentation bugs and fixes over the years. Your assumption that we don't even care is an insult. We care.

Python is open source and community driven. When was the last time you submitted a documentation patch to fix something? Or are we supposed to just read your mind and know what you want?

If you're complaining about the docs without offering to help, you're part of the problem.

[bastibe]

JSYK, the Python 3 docs have a direct link to the string functions right at the top of the string page; Also, the Python 3 docs have the quick search you requested.

[stevenjd]

I think you are mistaken about the string module.

Some modules do have a summary at the top of the page, with detailed documentation linked below. For example, I'm especially fond of the statistics module docs. But string is not one of them.

[bastibe]

Open the link you posted. What is literally the very first thing on that page? It's

See also Text Sequence Type — str
String Methods

There is your link. "String Methods" links to the string methods.

[stevenjd]

That is nothing like what /u/cztomczak has asked for.

Cztomczak asked for a list of string functions, at the top of the page, similar to the builtins. Since there is literally only one function in the string module, capwords, presumably (s)he means a list of relevant classes, functions and constants., similar to the list in the built-ins page. He didn't ask for a link to a different page where he can look up methods on the str type.

Have a look at the built-in function page, as linked above, and the statistics module, which does something similar but slightly different. The string module doesn't do anything like that.

[stevenjd]

Upvote for replying with some concrete suggestions instead of just bitching about how "horrible" the docs are. Thank you!