大家来投票:你读过视觉效果最好,最完善的开发文档是什么? - V2EX
V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
请不要在回答技术问题时复制粘贴 AI 生成的内容
Nasser
V2EX    程序员

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

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

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

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  
PRO
   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  
PRO
   2018-02-03 10:12:14 +08:00
@jameslan 比如说哪里烂?
目前有的问题就是文档不断更新,有些老文档里边的链接不对了
GG668v26Fd55CP5W
    12
GG668v26Fd55CP5W  
   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  
PRO
   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  
  nbsp;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 非常同意,腾讯公众平台的文档不堪入目,就是接个分享,想多了解一点都不行。客服人员也不大行,发个邮件问问题,所答非所问。来回几封邮件都没解决问题。
AV1
    94
AV1  
   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     Solana     2920 人在线   最高记录 6679       Select Language
创意工作者们的社区
World is powered by solitude
VERSION: 3.9.8.5 32ms UTC 14:32 PVG 22:32 LAX 07:32 JFK 10:32
Do have faith in what you're doing.
ubao snddm index pchome yahoo rakuten mypaper meadowduck bidyahoo youbao zxmzxm asda bnvcg cvbfg dfscv mmhjk xxddc yybgb zznbn ccubao uaitu acv GXCV ET GDG YH FG BCVB FJFH CBRE CBC GDG ET54 WRWR RWER WREW WRWER RWER SDG EW SF DSFSF fbbs ubao fhd dfg ewr dg df ewwr ewwr et ruyut utut dfg fgd gdfgt etg dfgt dfgd ert4 gd fgg wr 235 wer3 we vsdf sdf gdf ert xcv sdf rwer hfd dfg cvb rwf afb dfh jgh bmn lgh rty gfds cxv xcv xcs vdas fdf fgd cv sdf tert sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf shasha9178 shasha9178 shasha9178 shasha9178 shasha9178 liflif2 liflif2 liflif2 liflif2 liflif2 liblib3 liblib3 liblib3 liblib3 liblib3 zhazha444 zhazha444 zhazha444 zhazha444 zhazha444 dende5 dende denden denden2 denden21 fenfen9 fenf619 fen619 fenfe9 fe619 sdf sdf sdf sdf sdf zhazh90 zhazh0 zhaa50 zha90 zh590 zho zhoz zhozh zhozho zhozho2 lislis lls95 lili95 lils5 liss9 sdf0ty987 sdft876 sdft9876 sdf09876 sd0t9876 sdf0ty98 sdf0976 sdf0ty986 sdf0ty96 sdf0t76 sdf0876 df0ty98 sf0t876 sd0ty76 sdy76 sdf76 sdf0t76 sdf0ty9 sdf0ty98 sdf0ty987 sdf0ty98 sdf6676 sdf876 sd876 sd876 sdf6 sdf6 sdf9876 sdf0t sdf06 sdf0ty9776 sdf0ty9776 sdf0ty76 sdf8876 sdf0t sd6 sdf06 s688876 sd688 sdf86