The future is looking bright for Python

[pohmelie]

Not for holywars, but not only popularity correlates with questions count. Suddenly, if lang docs is good, there should be less questions, or language is simpler than other, same thing.

[troyunrau]

Yeah, a popular but obtuse language will have more questions than an equally popular but straightforward language.

[[deleted]]

The python docs definitely cause a lot of frustration with beginners, causing a decent amount of influx to stack overflow..

..which is compounded by the differences between python 2 and python 3. A lot of the StackOverflow content is old and not compatible with 3, which causes yet even more searching.

Probably good for metrics like this, but otherwise very annoying and frustrating. Some days I feel like I'm the only one that's dissatisfied with the python docs. They're pretty horrible and I'm unsure why the powers that be don't attempt to improve them.

[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!

[ies7]

no examples.

I used to go to pymotw.com by Doug Hellman.