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

2018-02-03 08:12:24 +08:00
 Nasser

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

9743 次点击
所在节点    程序员
96 条回复
ivydom
2018-02-03 10:44:40 +08:00
一个是 MDN (火狐开发者文档)
另外一个是 AUthing:
- https://github.com/Authing/authing
- https://docs.authing.cn/#/
zhidian
2018-02-03 10:46:24 +08:00
qt 不管是文档, example, 还是 API 设计, 都很棒 (不过我已经不写 C++ 了... 😆)
tausi0661
2018-02-03 10:47:42 +08:00
入行过 java 及其相关各种类库框架, html/cs/js 各种相关框架,类库, Mysql, 微软系列.Net, MSSQL, 各种第三方如 paypal, affirm, amazon, facebook, twitter 等, 以及微信官方(如果这也能算开发文档的话)

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

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

我觉得文档重要的还是要吧技术原理、特性、使用场合、注意问题,讲明白。让使用者结合专业知识自己会用,会思考,会判断,会架构,会设计。而不是手把手教小孩的模式。
chunqiuyiyu
2018-02-03 13:31:10 +08:00
当然是 MDN 了。
vibbow
2018-02-03 13:31:51 +08:00
MDN MSDN PHP

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/428135

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX