V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
Nasser
V2EX  ›  程序员

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

  •  1
     
  •   Nasser · 2018-02-03 08:12:24 +08:00 · 9682 次点击
    这是一个创建于 2245 天前的主题,其中的信息可能已经有所发展或是发生改变。

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

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

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

    http://guides.rubyonrails.org/

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

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

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

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

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

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