3 ms·
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 m
by sidlls 4y ago
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 4y agoOn 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 4y agoPython 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 https://docs.python.org/release/1.5.2/lib/lib.html
- dragonwriter 4y ago> 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 https://docs.python.org/3/library/index.html
- TylerE 4y agoBecause 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.