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

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

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

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

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

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

    http://guides.rubyonrails.org/

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

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

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

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

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

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