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

2019-06-29 13:47:55 +08:00
 2oTp
3039 次点击
所在节点    Python
12 条回复
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
意识流发帖，主题是啥根本看不出来
kppwp
2019-06-29 14:11:58 +08:00
意识流发帖哈哈哈哈
我觉得有一部分原因是函数定义不写类型和返回值，虽然大部分人都不会写，这确实影响了阅读
anonymous256
2019-06-29 15:09:37 +08:00
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
其他语言是指？
congeec
2019-06-30 12:47:22 +08:00
@szzhiyang 新版文档比以前的 msdn 好用多了

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

这是一个专为移动设备优化的页面（即为了让你能够在 Google 搜索结果里秒开这个页面），如果你希望参与 V2EX 社区的讨论，你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/578526

V2EX 是创意工作者们的社区，是一个分享自己正在做的有趣事物、交流想法，可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX