推荐学习书目
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 · Jun 29, 2019 · 3549 views
    This topic created in 2540 days ago, the information mentioned may be changed or developed.
    12 replies    2019-06-30 12:47:22 +08:00
    2oTp
        2
    2oTp  
    OP
       Jun 29, 2019
    其实我用的最多的还是 ipython 的 inspector
    2oTp
        3
    2oTp  
    OP
       Jun 29, 2019
    应该是 Introspection
    2oTp
        4
    2oTp  
    OP
       Jun 29, 2019
    urllib, urllib2, urllib3, urllib4, urllib5...
    0x000007b
        5
    0x000007b  
       Jun 29, 2019 via Android   ❤️ 1
    意识流发帖,主题是啥根本看不出来
    kppwp
        6
    kppwp  
       Jun 29, 2019 via iPhone
    意识流发帖哈哈哈哈
    我觉得有一部分原因是函数定义不写类型和返回值,虽然大部分人都不会写,这确实影响了阅读
    anonymous256
        7
    anonymous256  
       Jun 29, 2019 via Android
    python 文档还混乱么…没觉得。 标准库的,自带了 docstring,省了很多事,文档都不用看了。
    whileFalse
        8
    whileFalse  
       Jun 29, 2019
    看到引用链接里面用来对比的 JS 文档是 MDN 的我就笑了。

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

    话说 python 的 async/await 关键字我还是看 C#在 msdn 的一张图学会的
    About   ·   Help   ·   Advertise   ·   Blog   ·   API   ·   FAQ   ·   Solana   ·   3029 Online   Highest 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 43ms · UTC 05:38 · PVG 13:38 · LAX 22:38 · JFK 01:38
    ♥ Do have faith in what you're doing.