为什么 Python 的文档相比其他语言的文档 mess

V2EX = way to explore

V2EX 是一个关于分享和探索的地方

现在注册

已注册用户请登录

推荐学习书目

› Learn Python the Hard Way

Python Sites

› PyPI - Python Package Index

› http://diveintopython.org/toc/index.html

› Pocoo

值得关注的项目

› PyPy

› Celery

› Jinja2

› Read the Docs

› gevent

› pyenv

› virtualenv

› Stackless Python

› Beautiful Soup

› 结巴中文分词

› Green Unicorn

› Sentry

› Shovel

› Pyflakes

› pytest

Python 编程

› pep8 Checker

Styles

› PEP 8

› Google Python Style Guide

› Code Style from The Hitchhiker's Guide

这是一个创建于 1999 天前的主题，其中的信息可能已经有所发展或是发生改变。

文档

Python

mess

语言

12 条回复 • 2019-06-30 12:47:22 +08:00

2oTp

2019-06-29 13:48:46 +08:00

https://www.reddit.com/r/learnpython/comments/4sdw83/is_it_me_or_pythons_documentation_very_poorly/

2oTp

2019-06-29 13:55:59 +08:00

其实我用的最多的还是 ipython 的 inspector

2oTp

2019-06-29 13:56:59 +08:00

应该是 Introspection

2oTp

2019-06-29 13:58:08 +08:00

urllib, urllib2, urllib3, urllib4, urllib5...

0x000007b

2019-06-29 14:01:18 +08:00 via Android

意识流发帖，主题是啥根本看不出来

kppwp

2019-06-29 14:11:58 +08:00 via iPhone

意识流发帖哈哈哈哈
我觉得有一部分原因是函数定义不写类型和返回值，虽然大部分人都不会写，这确实影响了阅读

anonymous256

2019-06-29 15:09:37 +08:00 via Android

python 文档还混乱么…没觉得。标准库的，自带了 docstring，省了很多事，文档都不用看了。

whileFalse

2019-06-29 17:29:03 +08:00

看到引用链接里面用来对比的 JS 文档是 MDN 的我就笑了。

MDN 算是业界良心，一般网站没得比的。看看 Node 的文档水平你就知道了，参数都不带写全的。
https://nodejs.org/api/

szzhiyang

2019-06-29 18:06:52 +08:00

这里我要吹爆 Microsoft Docs ！

qcts33

2019-06-29 23:42:21 +08:00

我觉得还算可以吧，不过有一点比较烦的是很多函数的返回值是什么类型，实现了什么接口都不说清楚，害我总得先 type 一下才知道。

ulala

2019-06-30 00:03:11 +08:00 via iPhone

其他语言是指？

congeec

2019-06-30 12:47:22 +08:00 via iPhone

@szzhiyang 新版文档比以前的 msdn 好用多了

话说 python 的 async/await 关键字我还是看 C#在 msdn 的一张图学会的