[sidlls]

It's rich that the author unfavorably compares python's docs to go's. Go's documentation is barely more than API auto-doc level documentation: and many if not most of the open source projects using it have followed suit. It's some of the worst documentation out there, in my opinion.

[Ekaros]

On other hand that is often the part of documentation with Python I would love to have. And for a while I have missed with many python things.

[TylerE]

Python doc peaked for me with the 1.x “library index to keep under your pillow”

https://docs.python.org/release/1.5.2/lib/lib.html

[dragonwriter]

> Python doc peaked for me with the 1.x “library index to keep under your pillow”

I can see why that’s nice, but I find it odd to be described as a peak. While the details of the standard library it documents have evolved, I don’t see how the current version (linked from the main docs site with the same “keep this under your pillow” line) of the same portion of the docs is any worse:

https://docs.python.org/3/library/index.html

[TylerE]

Because it’s so much more readable without being littered with numerous examples and footnotes all over the place.

It just gave you exactly what you needed to know and otherwise stayed out of the way. Remember l, this was from an age when online doc didn’t really exist… I certainly never used the html version.

When you’re on dialup a local, quickly searchable version was very valuable.