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

文档

非官方

开发

投票

96 条回复 • 2018-02-08 08:11:39 +08:00

1

Nasser

OP

2018-02-03 08:13:05 +08:00

7

自己来回复一条：php 的文档真心不错，还是多语种的。

2

gamexg

2018-02-03 08:29:18 +08:00 via Android

5

.net 文档最好，但是基本不用啊

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

4

MinQ

2018-02-03 08:38:32 +08:00

MSDN 不知道能不能算？

5

suzic

2018-02-03 08:39:25 +08:00 via Android

mdn 的文档算吗？我查 js 只用它

6

askfilm

2018-02-03 08:54:16 +08:00

symfony 文档 +1

7

qiayue

2018-02-03 08:56:29 +08:00

微信公众平台和小程序的文档我就觉得写得很详细，只要通读了文档，几乎不需要再问人，开发没问题

8

jameslan

2018-02-03 08:59:52 +08:00 via Android

1

@qiayue 我怎么觉得很烂呢，感觉写文档的基本不懂技术

9

kimown

2018-02-03 09:01:00 +08:00 via Android

antd 的文档，有 code，有 example，有 jsfiddle

10

wanhuiming

2018-02-03 09:15:01 +08:00

没有投票，估计评论圈又是各种争议。

11

qiayue

2018-02-03 10:12:14 +08:00

@jameslan 比如说哪里烂？
目前有的问题就是文档不断更新，有些老文档里边的链接不对了

12

falcon05

2018-02-03 10:15:04 +08:00 via iPhone

1

django，文档完备，既能当教程又能当指南

13

January

2018-02-03 10:21:35 +08:00

stripe

14

Allianzcortex

2018-02-03 10:23:29 +08:00

1

Django 与 Qt ......文档典范吧

15

stzz

2018-02-03 10:24:09 +08:00 via Android

MSDN

16

tamlok

2018-02-03 10:27:46 +08:00 via Android

1

Qt 的文档太舒服了。除了有部分冷门的 class 写得不详细之外。

17

lonenol

2018-02-03 10:28:10 +08:00

你入行多久?看了多少文档?中文的还是英文的?

18

snowz

2018-02-03 10:29:12 +08:00 via iPhone

Qt 的吧

19

abcbuzhiming

2018-02-03 10:34:41 +08:00

目前为止，没有见过在全面，组织性能超过 MSDN 的文档

20

mamax

2018-02-03 10:41:51 +08:00 via Android

qt 无疑

21

ivydom

2018-02-03 10:44:40 +08:00

1

一个是 MDN （火狐开发者文档）
另外一个是 AUthing：
- https://github.com/Authing/authing
- https://docs.authing.cn/#/

22

zhidian

2018-02-03 10:46:24 +08:00

qt 不管是文档, example, 还是 API 设计, 都很棒 (不过我已经不写 C++ 了... 😆)

23

tausi0661

2018-02-03 10:47:42 +08:00

入行过 java 及其相关各种类库框架, html/cs/js 各种相关框架,类库, Mysql, 微软系列.Net, MSSQL, 各种第三方如 paypal, affirm, amazon, facebook, twitter 等, 以及微信官方(如果这也能算开发文档的话)

MSDN 的文档(特指英文版)详细度和清晰度, 并且最最重要的是正确度, 排第一应该是无悬念的.

24

bbsteel

2018-02-03 11:02:14 +08:00 via Android

mysql 开发文档，对比一下 sqlserver 的残废文档真是不知高哪里去了

25

abmin521

2018-02-03 11:05:48 +08:00

docker k8 py dj

26

mrcn

2018-02-03 11:06:57 +08:00 via Android

没人说 Laravel 吗...

27

Jiavan

2018-02-03 11:07:45 +08:00 via Android

1

developer.google.com

28

XinLake

2018-02-03 11:10:59 +08:00

1

@qiayue 小程序的文档我觉得不好
感觉内容是写给普通人看的，setp by setp 照着做就行，原理没讲清楚，好像本质就是 web app 吧。

Microsoft，Google 的文档虽然是英文，我觉得都很好，看懂就会用，正确的使用。不是机械试的 step by step。

29

qiayue

2018-02-03 11:23:10 +08:00

@XinLake 就是教你怎么开发小程序，并不是教你怎么开发小程序
前者是基于微信小程序体系开发 app
后者是阿里的需求，复制一个小程序体系

30

MeteorCat

2018-02-03 11:43:42 +08:00 via Android

@qiayue 微信支付的页面好像不统一，有的地方集成 SDK，有的页面没有 SDK 下载，而且有的请求参数也语焉不详，比如手机调起 H5 支付，有地地方支付的 url 有待 redirect_url，有的地方没带，那么这个地方是不需要参数 md5 哈希加入还是需要？而且有的地方感觉其他文档更新没同步，V3 版本的文档能够找到 V1 和 V2 文档的痕迹

31

xiaojie668329

2018-02-03 11:43:43 +08:00 via iPhone

MDN、Google Map。

32

isbase

2018-02-03 11:44:03 +08:00 via Android

https://reactjs.org

33

MeteorCat

2018-02-03 11:45:58 +08:00 via Android

@qiayue 有的微信支付里面并没有说明在支付的时候，支付域名不能带端口，允许二级域名，同时在回调地址以前我记得是只能授权的域名回调

34

yhxx

2018-02-03 11:54:48 +08:00

https://developers.google.com/web/

35

nicevar

2018-02-03 11:56:07 +08:00

Qt 的文档，IDE 里面全部搞定

36

jorneyr

2018-02-03 12:09:17 +08:00

最喜欢 Qt 的

37

mrcode

2018-02-03 12:14:07 +08:00

@yhxx +1

38

XinLake

2018-02-03 12:33:54 +08:00

1

@qiayue 教人怎么做的是教程了。
反正无脑跟着做就行，这点我最大的印象就是 csdn、cnblog 那些经典语句：“反正这样就可以了”、“这么改就没问题了”。一句话能吧人家几页英文图文资料说没了。

我觉得文档重要的还是要吧技术原理、特性、使用场合、注意问题，讲明白。让使用者结合专业知识自己会用，会思考，会判断，会架构，会设计。而不是手把手教小孩的模式。

39

chunqiuyiyu

2018-02-03 13:31:10 +08:00 via iPhone

当然是 MDN 了。

40

vibbow

2018-02-03 13:31:51 +08:00

2

MDN MSDN PHP

41

knktc

2018-02-03 14:20:01 +08:00

推荐 django 的文档~

42

TangMonk

2018-02-03 14:23:17 +08:00 via Android

msdn, rails, symfony

43

XIVN1987

2018-02-03 14:28:05 +08:00 via Android

Qt，虽然我用 PyQt

44

jeremaihloo

2018-02-03 14:32:16 +08:00

@qiayue #11 小程序的文档，真的很烂，就界面好点

45

zjsxwc

2018-02-03 14:37:20 +08:00

2

@qiayue #11

微信的文档写的很垃圾好不好，就像其他网友说的，好多地方会误导使用者，最好写代码还是要靠猜和看 sdk 代码才行。

46

youdiqs

2018-02-03 14:38:40 +08:00 via iPhone

realm

47

memorybox

2018-02-03 14:43:33 +08:00

python,Django, Mongodb, elasticsearch, splunk, flask, bitcoin...

48

gs139

2018-02-03 14:44:30 +08:00 via Android

thinkphp, vue

49

Luckyray

2018-02-03 14:47:01 +08:00

读过的不多，Docker 的感觉比较详细清晰

50

wellsc

2018-02-03 14:47:27 +08:00 via iPhone

Flask

51

chocotan

2018-02-03 15:40:11 +08:00

spring boot

52

mmm159357456

2018-02-03 15:44:27 +08:00

我觉得 angular 不错哇

53

noahsss

2018-02-03 16:15:11 +08:00

我觉得 Qt、Django 的文档写得很好

54

suzic

2018-02-03 16:26:50 +08:00

@mmm159357456 同感，可以直接当教程撸

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

56

qa2080639

2018-02-03 16:51:38 +08:00

php +1 文档下面还有网友提供的例子

57

Loyalsoldier

2018-02-03 17:17:06 +08:00

没什么人提 Vue.js 啊

58

gbin

2018-02-03 17:41:01 +08:00 via Android

node.js

59

odoooo

2018-02-03 17:45:39 +08:00

stripe.com/docs

60

septet

2018-02-03 18:00:17 +08:00 via iPhone

你说的效果好是指哪个方面，是信息量比较全的还是通俗易懂的

61

pq

2018-02-03 18:05:03 +08:00

VS 6.0 MSDN

62

aristotll

2018-02-03 18:22:36 +08:00

@somebody #55 Groovy 和 Gradle 为啥是不好的..

63

jx4hjy

2018-02-03 18:25:26 +08:00

Qt 用起来太舒服了

64

a881883

2018-02-03 18:44:59 +08:00

vue 不是针对谁，实在是太好了

65

qq976739120

2018-02-03 18:46:04 +08:00

django 的文档简直业界典范

66

navigaid

2018-02-03 19:29:19 +08:00

http://reference.wolfram.com/language/

67

shiweifu

2018-02-03 19:32:26 +08:00

第三方库的话，投 LeanCloud 一票

68

iszero

2018-02-03 19:42:00 +08:00 via Android

msdn

69

xd314697475

2018-02-03 19:49:23 +08:00

@qq976739120 django+1
体验确实很好

70

wyx984

2018-02-03 19:53:11 +08:00 via Android

用习惯了就好了。

71

YenvY

2018-02-03 20:07:04 +08:00

OpenSSL ×
mbedTLS √

72

plqws

2018-02-03 20:26:07 +08:00

Vue 文档是真的好，反观 React(Native) Angular 的文档简直就是文档界的耻辱

73

ToddTong

2018-02-03 20:26:29 +08:00

dubbo 吧

74

tairan2006

2018-02-03 20:53:43 +08:00

我记得 mongodb 的不错，solr 的一脸懵逼，es 的文档也不错…

框架就多了，django 的很规整，flask 的源码文档写的棒极了…最后 Java 系的文档我都不太爱看

75

xiaojie668329

2018-02-03 20:56:04 +08:00 via iPhone

补一个，mongodb 的文档真的超级好。

76

zetary

2018-02-03 21:05:18 +08:00

scikit-learn...对着文档简直可以把大半机器学习的知识都学一遍...

77

CatCode

2018-02-03 21:09:24 +08:00

微软的文档没话说，各方面都很全面，
特别是文档末尾：这项功能在.Net Framework x.x 版本中可用和是线程安全的
这两项，真的太好了

78

defphilip

2018-02-03 21:11:13 +08:00

Qt 的文档是我见过最好的了
MSDN 的一大部分文档

79

forestyuan

2018-02-03 21:19:48 +08:00

MSDN+1

80

liuzuo

2018-02-03 21:21:23 +08:00

@xiaojie668329
就 mongo 的文档没看明白，可能是因为我英文造诣不好。。。。。。
反正我是分不清文档那里是适用于集群的，那里是适用于单点的。

81

searene

2018-02-03 21:39:13 +08:00

react 的官方入门教程比较好，看完基本就可以写代码了

82

Nick

2018-02-03 22:34:01 +08:00

https://atlassian.design

83

Crossin

2018-02-03 23:02:03 +08:00

django+1

84

mlyy

2018-02-03 23:23:41 +08:00 via iPhone

wiki.archlinux.org

85

zhouheyang0919

2018-02-03 23:27:52 +08:00

rust

86

douglas1997

2018-02-04 00:15:12 +08:00

opencv

87

AlwaysBehave

2018-02-04 00:36:41 +08:00

@mrcn 不觉得 Laravel 的文档写的很好
很多都要自己去追源码里面的实现才能理解为什么是这样子的

88

shiny

2018-02-04 00:38:01 +08:00

Redis 的文档能直接运行示例，非常棒

89

akira

2018-02-04 02:03:55 +08:00

微软，谷歌，非死不可，清晰明了易懂
AWS 的文档很详细，但是看起来很容易烦躁

90

chengxiao

2018-02-04 02:16:36 +08:00

国内几家大厂的都极差没错说的就是腾讯公众平台

91

danielzhang0212

2018-02-04 05:32:10 +08:00

个人觉得 Golang 的文档看着就挺清楚的。不过不知道符不符合楼主视觉效果的标准。https://golang.org/doc/

92

nightcat

2018-02-04 06:03:48 +08:00

1

@mlyy wiki.gentoo.org

93

ooops

2018-02-04 16:14:24 +08:00

@chengxiao 非常同意，腾讯公众平台的文档不堪入目，就是接个分享，想多了解一点都不行。客服人员也不大行，发个邮件问问题，所答非所问。来回几封邮件都没解决问题。

94

DOLLOR

2018-02-04 22:31:05 +08:00

Qt。
MDN：如果你英语比较好，MDN 作为学习和参考都是非常优秀的，比某些 w3xx 开头之类的好多了。

95

cstj0505

2018-02-05 10:38:02 +08:00

postgresql 的文档真的不要太详细

96

sothx

2018-02-08 08:11:39 +08:00 via iPhone

Vue.js
iView
Elementi-UI 都挺喜欢他们的文档的