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
2oTp
V2EX  ›  Python

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

  •  
  •   2oTp · 2019-06-29 13:47:55 +08:00 · 3021 次点击
    这是一个创建于 1966 天前的主题,其中的信息可能已经有所发展或是发生改变。
    12 条回复    2019-06-30 12:47:22 +08:00
    2oTp
        2
    2oTp  
    OP
       2019-06-29 13:55:59 +08:00
    其实我用的最多的还是 ipython 的 inspector
    2oTp
        3
    2oTp  
    OP
       2019-06-29 13:56:59 +08:00
    应该是 Introspection
    2oTp
        4
    2oTp  
    OP
       2019-06-29 13:58:08 +08:00
    urllib, urllib2, urllib3, urllib4, urllib5...
    0x000007b
        5
    0x000007b  
       2019-06-29 14:01:18 +08:00 via Android   ❤️ 1
    意识流发帖,主题是啥根本看不出来
    kppwp
        6
    kppwp  
       2019-06-29 14:11:58 +08:00 via iPhone
    意识流发帖哈哈哈哈
    我觉得有一部分原因是函数定义不写类型和返回值,虽然大部分人都不会写,这确实影响了阅读
    anonymous256
        7
    anonymous256  
       2019-06-29 15:09:37 +08:00 via Android
    python 文档还混乱么…没觉得。 标准库的,自带了 docstring,省了很多事,文档都不用看了。
    whileFalse
        8
    whileFalse  
       2019-06-29 17:29:03 +08:00
    看到引用链接里面用来对比的 JS 文档是 MDN 的我就笑了。

    MDN 算是业界良心,一般网站没得比的。看看 Node 的文档水平你就知道了,参数都不带写全的。
    https://nodejs.org/api/
    szzhiyang
        9
    szzhiyang  
       2019-06-29 18:06:52 +08:00
    这里我要吹爆 Microsoft Docs !
    qcts33
        10
    qcts33  
       2019-06-29 23:42:21 +08:00
    我觉得还算可以吧,不过有一点比较烦的是很多函数的返回值是什么类型,实现了什么接口都不说清楚,害我总得先 type 一下才知道。
    ulala
        11
    ulala  
       2019-06-30 00:03:11 +08:00 via iPhone
    其他语言是指?
    congeec
        12
    congeec  
       2019-06-30 12:47:22 +08:00 via iPhone
    @szzhiyang 新版文档比以前的 msdn 好用多了

    话说 python 的 async/await 关键字我还是看 C#在 msdn 的一张图学会的
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   5754 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 34ms · UTC 06:09 · PVG 14:09 · LAX 22:09 · JFK 01:09
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.