为什么要学会阅读源码?因为不读源码你压根没法用啊,阿里这文档写的什么玩意儿。。。
啥功能都是寥寥数语,各种配置的参数也都不全,碰到点问题还得各种翻博客……
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 这种命名的。。。
|