• 请不要在回答技术问题时复制粘贴 AI 生成的内容
Nasser
V2EX  ›  程序员

大家来投票:你读过视觉效果最好,最完善的开发文档是什么?

  •  1
     
  •   Nasser · Feb 3, 2018 · 11121 views
    This topic created in 3031 days ago, the information mentioned may be changed or developed.

    从入行以来,接触了太多了官方文档和非官方文档 部分文档真的是看的好累😫 你们读过最好的开发文档是什么?

    96 replies    2018-02-08 08:11:39 +08:00
    Nasser
        1
    Nasser  
    OP
       Feb 3, 2018   ❤️ 7
    自己来回复一条:php 的文档真心不错,还是多语种的。
    gamexg
        2
    gamexg  
       Feb 3, 2018 via Android   ❤️ 5
    .net 文档最好,但是基本不用啊
    zjsxwc
        3
    zjsxwc  
       Feb 3, 2018
    历史久且流行的主流框架的文档都可以,比如 symfony、rails、spring

    https://symfony.com/doc/current/index.html

    http://guides.rubyonrails.org/

    https://spring.io/guides
    MinQ
        4
    MinQ  
       Feb 3, 2018
    MSDN 不知道能不能算?
    suzic
        5
    suzic  
       Feb 3, 2018 via Android
    mdn 的文档算吗?我查 js 只用它
    askfilm
        6
    askfilm  
       Feb 3, 2018
    symfony 文档 +1
    qiayue
        7
    qiayue  
    PRO
       Feb 3, 2018
    微信公众平台和小程序的文档我就觉得写得很详细,只要通读了文档,几乎不需要再问人,开发没问题
    jameslan
        8
    jameslan  
       Feb 3, 2018 via Android   ❤️ 1
    @qiayue 我怎么觉得很烂呢,感觉写文档的基本不懂技术
    kimown
        9
    kimown  
       Feb 3, 2018 via Android
    antd 的文档,有 code,有 example,有 jsfiddle
    wanhuiming
        10
    wanhuiming  
       Feb 3, 2018
    没有投票,估计评论圈又是各种争议。
    qiayue
        11
    qiayue  
    PRO
       Feb 3, 2018
    @jameslan 比如说哪里烂?
    目前有的问题就是文档不断更新,有些老文档里边的链接不对了
    GG668v26Fd55CP5W
        12
    GG668v26Fd55CP5W  
       Feb 3, 2018 via iPhone   ❤️ 1
    django,文档完备,既能当教程又能当指南
    January
        13
    January  
    PRO
       Feb 3, 2018
    stripe
    Allianzcortex
        14
    Allianzcortex  
       Feb 3, 2018   ❤️ 1
    Django 与 Qt ......文档典范吧
    stzz
        15
    stzz  
       Feb 3, 2018 via Android
    MSDN
    tamlok
        16
    tamlok  
       Feb 3, 2018 via Android   ❤️ 1
    Qt 的文档太舒服了。除了有部分冷门的 class 写得不详细之外。
    lonenol
        17
    lonenol  
       Feb 3, 2018
    你入行多久?看了多少文档?中文的还是英文的?
    snowz
        18
    snowz  
       Feb 3, 2018 via iPhone
    Qt 的吧
    abcbuzhiming
        19
    abcbuzhiming  
       Feb 3, 2018
    目前为止,没有见过在全面,组织性能超过 MSDN 的文档
    mamax
        20
    mamax  
       Feb 3, 2018 via Android
    qt 无疑
    ivydom
        21
    ivydom  
       Feb 3, 2018   ❤️ 1
    一个是 MDN (火狐开发者文档)
    另外一个是 AUthing:
    - https://github.com/Authing/authing
    - https://docs.authing.cn/#/
    zhidian
        22
    zhidian  
       Feb 3, 2018
    qt 不管是文档, example, 还是 API 设计, 都很棒 (不过我已经不写 C++ 了... 😆)
    tausi0661
        23
    tausi0661  
       Feb 3, 2018
    入行过 java 及其相关各种类库框架, html/cs/js 各种相关框架,类库, Mysql, 微软系列.Net, MSSQL, 各种第三方如 paypal, affirm, amazon, facebook, twitter 等, 以及微信官方(如果这也能算开发文档的话)

    MSDN 的文档(特指英文版)详细度和清晰度, 并且最最重要的是正确度, 排第一应该是无悬念的.
    bbsteel
        24
    bbsteel  
       Feb 3, 2018 via Android
    mysql 开发文档,对比一下 sqlserver 的残废文档真是不知高哪里去了
    abmin521
        25
    abmin521  
       Feb 3, 2018
    docker k8 py dj
    mrcn
        26
    mrcn  
       Feb 3, 2018 via Android
    没人说 Laravel 吗...
    Jiavan
        27
    Jiavan  
       Feb 3, 2018 via Android   ❤️ 1
    XinLake
        28
    XinLake  
       Feb 3, 2018   ❤️ 1
    @qiayue 小程序的文档我觉得不好
    感觉内容是写给普通人看的,setp by setp 照着做就行,原理没讲清楚,好像本质就是 web app 吧。

    Microsoft,Google 的文档虽然是英文,我觉得都很好,看懂就会用,正确的使用。不是机械试的 step by step。
    qiayue
        29
    qiayue  
    PRO
       Feb 3, 2018
    @XinLake 就是教你怎么开发小程序,并不是教你怎么开发小程序
    前者是基于微信小程序体系开发 app
    后者是阿里的需求,复制一个小程序体系
    MeteorCat
        30
    MeteorCat  
       Feb 3, 2018 via Android
    @qiayue 微信支付的页面好像不统一,有的地方集成 SDK,有的页面没有 SDK 下载,而且有的请求参数也语焉不详,比如手机调起 H5 支付,有地地方支付的 url 有待 redirect_url,有的地方没带,那么这个地方是不需要参数 md5 哈希加入还是需要?而且有的地方感觉其他文档更新没同步,V3 版本的文档能够找到 V1 和 V2 文档的痕迹
    voidcomma
        31
    voidcomma  
       Feb 3, 2018 via iPhone
    MDN、Google Map。
    isbase
        32
    isbase  
    PRO
       Feb 3, 2018 via Android
    MeteorCat
        33
    MeteorCat  
       Feb 3, 2018 via Android
    @qiayue 有的微信支付里面并没有说明在支付的时候,支付域名不能带端口,允许二级域名,同时在回调地址以前我记得是只能授权的域名回调
    yhxx
        34
    yhxx  
       Feb 3, 2018
    nicevar
        35
    nicevar  
       Feb 3, 2018
    Qt 的文档,IDE 里面全部搞定
    jorneyr
        36
    jorneyr  
       Feb 3, 2018
    最喜欢 Qt 的
    mrcode
        37
    mrcode  
       Feb 3, 2018
    @yhxx +1
    XinLake
        38
    XinLake  
       Feb 3, 2018   ❤️ 1
    @qiayue 教人怎么做的是教程了。
    反正无脑跟着做就行,这点我最大的印象就是 csdn、cnblog 那些经典语句:“反正这样就可以了”、“这么改就没问题了”。一句话能吧人家几页英文图文资料说没了。

    我觉得文档重要的还是要吧技术原理、特性、使用场合、注意问题,讲明白。让使用者结合专业知识自己会用,会思考,会判断,会架构,会设计。而不是手把手教小孩的模式。
    chunqiuyiyu
        39
    chunqiuyiyu  
       Feb 3, 2018 via iPhone
    当然是 MDN 了。
    vibbow
        40
    vibbow  
       Feb 3, 2018   ❤️ 2
    MDN MSDN PHP
    knktc
        41
    knktc  
       Feb 3, 2018
    推荐 django 的文档~
    TangMonk
        42
    TangMonk  
       Feb 3, 2018 via Android
    msdn, rails, symfony
    XIVN1987
        43
    XIVN1987  
       Feb 3, 2018 via Android
    Qt,虽然我用 PyQt
    jeremaihloo
        44
    jeremaihloo  
       Feb 3, 2018
    @qiayue #11 小程序的文档,真的很烂,就界面好点
    zjsxwc
        45
    zjsxwc  
       Feb 3, 2018   ❤️ 2
    @qiayue #11

    微信的文档写的很垃圾好不好,就像其他网友说的,好多地方会误导使用者,最好写代码还是要靠猜和看 sdk 代码才行。
    youdiqs
        46
    youdiqs  
       Feb 3, 2018 via iPhone
    realm
    memorybox
        47
    memorybox  
       Feb 3, 2018
    python,Django, Mongodb, elasticsearch, splunk, flask, bitcoin...
    gs139
        48
    gs139  
       Feb 3, 2018 via Android
    thinkphp, vue
    Luckyray
        49
    Luckyray  
       Feb 3, 2018
    读过的不多,Docker 的感觉比较详细清晰
    wellsc
        50
    wellsc  
       Feb 3, 2018 via iPhone
    Flask
    chocotan
        51
    chocotan  
       Feb 3, 2018
    spring boot
    MasterofNone
        52
    MasterofNone  
       Feb 3, 2018
    我觉得 angular 不错哇
    noahsss
        53
    noahsss  
       Feb 3, 2018
    我觉得 Qt、Django 的文档写得很好
    suzic
        54
    suzic  
       Feb 3, 2018
    @mmm159357456 同感,可以直接当教程撸
    somebody
        55
    somebody  
       Feb 3, 2018 via Android
    写的好的:Android, Qt, MSDN, Python, cppreference.com, man, vim
    还行的:Kotlin
    不好的:Groovy, Gradle, maven Central
    qa2080639
        56
    qa2080639  
       Feb 3, 2018
    php +1 文档下面还有网友提供的例子
    Loyalsoldier
        57
    Loyalsoldier  
       Feb 3, 2018
    没什么人提 Vue.js 啊
    gbin
        58
    gbin  
       Feb 3, 2018 via Android
    node.js
    odoooo
        59
    odoooo  
       Feb 3, 2018
    septet
        60
    septet  
       Feb 3, 2018 via iPhone
    你说的效果好是指哪个方面,是信息量比较全的还是通俗易懂的
    pq
        61
    pq  
       Feb 3, 2018
    VS 6.0 MSDN
    aristotll
        62
    aristotll  
       Feb 3, 2018
    @somebody #55 Groovy 和 Gradle 为啥是不好的..
    jx4hjy
        63
    jx4hjy  
       Feb 3, 2018
    Qt 用起来太舒服了
    a881883
        64
    a881883  
       Feb 3, 2018
    vue 不是针对谁,实在是太好了
    qq976739120
        65
    qq976739120  
       Feb 3, 2018
    django 的文档简直业界典范
    navigaid
        66
    navigaid  
       Feb 3, 2018
    shiweifu
        67
    shiweifu  
       Feb 3, 2018
    第三方库的话,投 LeanCloud 一票
    iszero
        68
    iszero  
       Feb 3, 2018 via Android
    msdn
    xd314697475
        69
    xd314697475  
       Feb 3, 2018
    @qq976739120 django+1
    体验确实很好
    wyx984
        70
    wyx984  
       Feb 3, 2018 via Android
    用习惯了就好了。
    fixmestan
        71
    fixmestan  
       Feb 3, 2018
    OpenSSL ×
    mbedTLS √
    plqws
        72
    plqws  
       Feb 3, 2018
    Vue 文档是真的好,反观 React(Native) Angular 的文档简直就是文档界的耻辱
    ToddTong
        73
    ToddTong  
       Feb 3, 2018
    dubbo 吧
    tairan2006
        74
    tairan2006  
       Feb 3, 2018
    我记得 mongodb 的不错,solr 的一脸懵逼,es 的文档也不错…

    框架就多了,django 的很规整,flask 的源码文档写的棒极了…最后 Java 系的文档我都不太爱看
    voidcomma
        75
    voidcomma  
       Feb 3, 2018 via iPhone
    补一个,mongodb 的文档真的超级好。
    zetary
        76
    zetary  
       Feb 3, 2018
    scikit-learn...对着文档简直可以把大半机器学习的知识都学一遍...
    CatCode
        77
    CatCode  
       Feb 3, 2018
    微软的文档没话说,各方面都很全面,
    特别是文档末尾:这项功能在.Net Framework x.x 版本中可用 和 是线程安全的
    这两项,真的太好了
    defphilip
        78
    defphilip  
       Feb 3, 2018
    Qt 的文档是我见过最好的了
    MSDN 的一大部分文档
    forestyuan
        79
    forestyuan  
       Feb 3, 2018
    MSDN+1
    liuzuo
        80
    liuzuo  
       Feb 3, 2018
    @xiaojie668329
    就 mongo 的文档没看明白,可能是因为我英文造诣不好。。。。。。
    反正我是分不清文档那里是适用于集群的,那里是适用于单点的。
    searene
        81
    searene  
       Feb 3, 2018
    react 的官方入门教程比较好,看完基本就可以写代码了
    Nick
        82
    Nick  
       Feb 3, 2018
    https://atlassian.design
    Crossin
        83
    Crossin  
       Feb 3, 2018
    django+1
    mlyy
        84
    mlyy  
       Feb 3, 2018 via iPhone
    zhouheyang0919
        85
    zhouheyang0919  
       Feb 3, 2018
    rust
    douglas1997
        86
    douglas1997  
       Feb 4, 2018
    opencv
    AlwaysBehave
        87
    AlwaysBehave  
       Feb 4, 2018
    @mrcn 不觉得 Laravel 的文档写的很好
    很多都要自己去追源码里面的实现才能理解为什么是这样子的
    shiny
        88
    shiny  
    PRO
       Feb 4, 2018
    Redis 的文档能直接运行示例,非常棒
    akira
        89
    akira  
       Feb 4, 2018
    微软,谷歌,非死不可 ,清晰明了易懂
    AWS 的文档很详细,但是看起来很容易烦躁
    chengxiao
        90
    chengxiao  
       Feb 4, 2018
    国内几家大厂的都极差 没错说的就是腾讯 公众平台
    danielzhang0212
        91
    danielzhang0212  
       Feb 4, 2018
    个人觉得 Golang 的文档看着就挺清楚的。不过不知道符不符合楼主视觉效果的标准。https://golang.org/doc/
    nightcat
        92
    nightcat  
       Feb 4, 2018   ❤️ 1
    ooops
        93
    ooops  
       Feb 4, 2018
    @chengxiao 非常同意,腾讯公众平台的文档不堪入目,就是接个分享,想多了解一点都不行。客服人员也不大行,发个邮件问问题,所答非所问。来回几封邮件都没解决问题。
    AV1
        94
    AV1  
       Feb 4, 2018
    Qt。
    MDN:如果你英语比较好,MDN 作为学习和参考都是非常优秀的,比某些 w3xx 开头之类的好多了。
    cstj0505
        95
    cstj0505  
       Feb 5, 2018
    postgresql 的文档真的不要太详细
    sothx
        96
    sothx  
       Feb 8, 2018 via iPhone
    Vue.js
    iView
    Elementi-UI 都挺喜欢他们的文档的
    About   ·   Help   ·   Advertise   ·   Blog   ·   API   ·   FAQ   ·   Solana   ·   1880 Online   Highest 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 229ms · UTC 00:01 · PVG 08:01 · LAX 17:01 · JFK 20:01
    ♥ Do have faith in what you're doing.