读 rocketmq 文档有感
这是一个创建于 1311 天前的主题，其中的信息可能已经有所发展或是发生改变。
为什么要学会阅读源码？因为不读源码你压根没法用啊，阿里这文档写的什么玩意儿。。。
啥功能都是寥寥数语，各种配置的参数也都不全，碰到点问题还得各种翻博客……
第 1 条附言 2022-03-10 13:25:09 +08:00
主要后端八股文落在 rocketmq 和 kafla 上，base 杭州
 | 1 Vegetable 2022-03-10 10:50:31 +08:00 某些开源项目确实是这样的。我曾经也有过同样的感叹。 对 Java 生态的感触也最深。某些很流行的开源库，文档不行，代码注释也不行。遇到不清楚的点只能研读代码。 上一个令我产生这种感叹的是 mybatis-plus |
 | 2 Jekins 2022-03-10 10:53:22 +08:00 学 redis 的时候不看博客根本不行..官方没有 springboot 版本的文档. spring data 关于配置的寥寥几笔带过..完全不知道怎么配置.最后还是要翻博客... |
 | 4 hun2008hun 2022-03-10 11:20:01 +08:00 同感，rocketmq 文档真的是一言难尽 |
 | 5 miscnote 2022-03-10 11:22:03 +08:00 rabbitmq 的文档就很强。 |
 | 6 q474818917 2022-03-10 11:23:37 +08:00 一般人还是真不推荐用阿里开源的产品，生产遇到各种奇葩问题，简直就是小白鼠 |
 | 7 RichardYyf 2022-03-10 11:24:14 +08:00 哈哈哈，RocketMQ 文档真的一言难尽，对比 Pulsar 、RabbitMQ |
 | 9 nekoneko 2022-03-10 11:30:45 +08:00 国内文档建设真的差好多 |
 | 10 bk201 2022-03-10 11:37:57 +08:00 可能文档写的太细的话，没法推自己的商业版 |
 | 11 scxiazi 2022-03-10 11:39:39 +08:00  1 除了吹自己性能好, 写几个 demo,剩下得啥也不写 |
 | 12 timepast 2022-03-10 11:47:19 +08:00 公司有个项目,用到 BladeX ，项目开源，但文档收费 |
 | 13 ciki 2022-03-10 12:01:59 +08:00 rocketmq 可是有商用版本的，开源版本可想而知了 |
 | 14 pengtdyd 2022-03-10 12:44:25 +08:00 1 和我用一个头像 真是英雄所见略同啊 |
 | 15 bigbyto 2022-03-10 12:49:26 +08:00 1 我一直没搞懂为什么选型的时候会选 rocketmq ，做决策的人是完整看过它的代码，了解它的架构吗？这玩意从开源到现在几年了，文档基本上一点变化都没有，怎么敢用这种东西在生产环境的。 |
| 16 pengtdyd 2022-03-10 12:58:21 +08:00 4 说阿里文档垃圾的人，大概率是没有看过微信的文档，这是我目前见过的最垃圾的文档 |
 | 20 Kontinue OP @scxiazi 是的老外开源的东西要不就有文档，文档写的粗的一般 examples 也会详细写，rocket 这个文档文档不行，demodemo 不行…… |
 | 21 Konys 2022-03-10 13:31:28 +08:00 阿里的文档我觉得比微信还强点，微信的更是一言难尽 |
 | 22 CaptainD 2022-03-10 13:42:52 +08:00 读阿里云的文档我以为我在读文言文 |
 | 23 seesky 2022-03-10 14:00:04 +08:00 感觉有些文档美其名曰简洁凝练，结果就导致一种奇怪的情况，不会的人看不懂，看的懂的人本身就已经会了。 |
 | 24 uSy62nMkdH 2022-03-10 15:08:00 +08:00 我要吹一下 docker 的文档 |
 | 26 olaloong 2022-03-10 17:09:32 +08:00 阿里开源基本操作，fastjson 也是，文档注释要啥没啥 慎用阿里开源 |
 | 27 zt5b79527 2022-03-10 17:13:35 +08:00 确实，真要提高，还是得读源码，博客什么的都是别人的东西。 真要变成自己的东西，还是得读源码，写博客 /笔记。 |
 | 28 twing37 2022-03-10 17:18:43 +08:00 #24 那我可要吹 rust 了 |
 | 30 to2false 2022-03-10 17:42:21 +08:00 大概率因为文档不在 kpi 范围内 |
| 31 olaloong 2022-03-10 17:54:32 +08:00 |
 | 32 monetto 2022-03-10 19:07:10 +08:00 1 FastJson Fast 倒是没多 Fast ，一堆 Issue... |
 | 33 EarthChild 2022-03-10 19:11:35 +08:00 所以。很多 MQ 教程大佬都推荐 RabbitMQ |
 | 34 documentzhangx66 2022-03-10 20:31:09 +08:00 从学习效率与作用的角度来看，去读代码，不如去学习，去自己做原型设计。 |
 | 36 kingfalse 2022-03-10 22:34:20 +08:00 via Android 国产，哪有文档这玩意存在， |
 | 37 skiy 2022-03-10 23:14:30 +08:00 其实文档详细的还是有的，比如 thinkphp 。 哈哈。 别人的开源项目：文档好垃圾； 自己开源的项目：写文档浪费时间；凭什么浪费我陪孩子的时间去把文档写得这么详细； 说实在的，老外开源的项目（知名项目），源代码里面的注释非常多（方法前面几大段几大段的注释）。关于开源治理这块，我们差了很多。比如 Rust 开发团队都分 文档团队、仓库团队、核心团队什么的。。。 |
 | 38 neoblackcap 2022-03-11 01:01:11 +08:00 文档本来是有的，好像爆出过，开源之前要把文档干掉 |
 | 39 night98 2022-03-11 01:37:36 +08:00 rocketmq 包括对应的 java sdk ，阅读源码问题也挺多的，基本上没注释，还得根据上下文推测，其他稍微用心做的开源都没这毛病，比如 hutool |
 | 40 plko345 2022-03-11 08:16:07 +08:00 via Android 公司里选型的时候，非常痛恨那些选阿里的，没有一个好用的，噩梦 |
 | 41 sampeng 2022-03-11 08:29:07 +08:00 via iPhone 绝大部分选型是拍脑袋，一不看 issue 更新情况二不看代码发布频率不看文档不看 demo 丰富程度是基操了。看源码？那更不可能。反正就是跟风人云亦云…要换语言就是 java ，要用 java 就是 spring cloud 全家桶，都不带考虑只用 spring boot 的，要用全家桶就是 nacos 。因为用的人多所以没问题是很多人基本的逻辑自洽…但我其实完全理解这个决策流程… |
 | 43 DinnyXu 2022-03-11 09:25:10 +08:00 正儿八经的看过 RabbitMQ 的文档和实践过后，再去玩 RocketMQ ，那才真是差距大，开源的 RabbitMQ 的监控页面都比阿里开源的监控页面好看 100 倍...光是这点 rocket 就已经败了 |
 | 44 tairan2006 2022-03-11 10:01:31 +08:00 rocketMQ 我记得不是对标 kafka 的么，和 rabbitmq 不是一个使用场景吧… |
 | 45 Tinet 2022-03-11 11:12:33 +08:00 rocketmq 感觉是有点随意，配置项都是用 brokerIP1,brokerIP2 这种命名的。。。 |
Select Language