读 rocketmq 文档有感

[Kontinue]

为什么要学会阅读源码？因为不读源码你压根没法用啊，阿里这文档写的什么玩意儿。。。

啥功能都是寥寥数语，各种配置的参数也都不全，碰到点问题还得各种翻博客……

[Konys]

阿里的文档我觉得比微信还强点，微信的更是一言难尽

[CaptainD]

读阿里云的文档我以为我在读文言文

[seesky]

感觉有些文档美其名曰简洁凝练，结果就导致一种奇怪的情况，不会的人看不懂，看的懂的人本身就已经会了。

[uSy62nMkdH]

我要吹一下 docker 的文档

[Kontinue]

@seesky 就是这个感觉啊

[olaloong]

阿里开源基本操作，fastjson 也是，文档注释要啥没啥
慎用阿里开源

[zt5b79527]

确实，真要提高，还是得读源码，博客什么的都是别人的东西。
真要变成自己的东西，还是得读源码，写博客 /笔记。

[twing37]

#24 那我可要吹 rust 了

[Kontinue]

@olaloong 那 fastjson 倒是不用文档哈哈哈，直接用……

[to2false]

大概率因为文档不在 kpi 范围内

[olaloong]

@Kontinue 常用 api 确实很香，但是但凡用到点高级功能，比如 @JSONType ，就炸了。18 年就挂着的 bug issue 到现在还没修呢
注解属性文档也没有，代码里也没注释，要么看名字猜，要么看源码吧

[monetto]

FastJson Fast 倒是没多 Fast ，一堆 Issue...

[EarthChild]

所以。很多 MQ 教程大佬都推荐 RabbitMQ

[documentzhangx66]

从学习效率与作用的角度来看，去读代码，不如去学习，去自己做原型设计。

[mikulch]

@Vegetable 看下 fastjson 你会觉得 mbp 文档真棒！

[kingfalse]

国产，哪有文档这玩意存在，

[skiy]

其实文档详细的还是有的，比如 thinkphp 。

哈哈。
别人的开源项目：文档好垃圾；
自己开源的项目：写文档浪费时间；凭什么浪费我陪孩子的时间去把文档写得这么详细；

说实在的，老外开源的项目（知名项目），源代码里面的注释非常多（方法前面几大段几大段的注释）。关于开源治理这块，我们差了很多。比如 Rust 开发团队都分 文档团队、仓库团队、核心团队什么的。。。

[neoblackcap]

文档本来是有的，好像爆出过，开源之前要把文档干掉

[night98]

rocketmq 包括对应的 java sdk ，阅读源码问题也挺多的，基本上没注释，还得根据上下文推测，其他稍微用心做的开源都没这毛病，比如 hutool

[plko345]

公司里选型的时候，非常痛恨那些选阿里的，没有一个好用的，噩梦