5

读 rocketmq 文档有感

 2 years ago
source link: https://www.v2ex.com/t/839337
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.
neoserver,ios ssh client

V2EX  ›  程序员

读 rocketmq 文档有感

  Kontinue · 1 day ago · 4147 views

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

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

Supplement 1  ·  1 day ago

主要后端八股文落在 rocketmq 和 kafla 上,base 杭州
45 replies    2022-03-11 11:12:33 +08:00

Vegetable

Vegetable      1 day ago

某些开源项目确实是这样的。我曾经也有过同样的感叹。
对 Java 生态的感触也最深。某些很流行的开源库,文档不行,代码注释也不行。遇到不清楚的点只能研读代码。
上一个令我产生这种感叹的是 mybatis-plus

Jekins

Jekins      1 day ago

学 redis 的时候不看博客根本不行..官方没有 springboot 版本的文档. spring data 关于配置的寥寥几笔带过..完全不知道怎么配置.最后还是要翻博客...

Kontinue

Kontinue      1 day ago

@Jekins redis 资料还是很多的,我吐槽的点在于国人的开源,官方中文的文档,却不如别人的博客……

hun2008hun

hun2008hun      1 day ago

同感,rocketmq 文档真的是一言难尽

miscnote

miscnote      1 day ago

rabbitmq 的文档就很强。

q474818917

q474818917      1 day ago

一般人还是真不推荐用阿里开源的产品,生产遇到各种奇葩问题,简直就是小白鼠

RichardYyf

RichardYyf      1 day ago

哈哈哈,RocketMQ 文档真的一言难尽,对比 Pulsar 、RabbitMQ

nekoneko

nekoneko      1 day ago

@Vegetable #1 mybatic plus 的文档真是一言难尽, 版本更新都不带更新文档的

nekoneko

nekoneko      1 day ago

国内文档建设真的差好多

bk201

bk201      1 day ago

可能文档写的太细的话,没法推自己的商业版

scxiazi

scxiazi      1 day ago   ❤️ 1

除了吹自己性能好, 写几个 demo,剩下得啥也不写

timepast

timepast      1 day ago

公司有个项目,用到 BladeX ,项目开源,但文档收费

ciki

ciki      1 day ago

rocketmq 可是有商用版本的,开源版本可想而知了

pengtdyd

pengtdyd      1 day ago   ❤️ 1

和我用一个头像 真是英雄所见略同啊

bigbyto

bigbyto      1 day ago   ❤️ 1

我一直没搞懂为什么选型的时候会选 rocketmq ,做决策的人是完整看过它的代码,了解它的架构吗?这玩意从开源到现在几年了,文档基本上一点变化都没有,怎么敢用这种东西在生产环境的。

pengtdyd

pengtdyd      1 day ago   ❤️ 4

说阿里文档垃圾的人,大概率是没有看过微信的文档,这是我目前见过的最垃圾的文档

Kontinue

Kontinue      1 day ago

@bigbyto 嗷,我现在在面向面试学习中……但其实消息量不大,用啥都一样吧

Kontinue

Kontinue      1 day ago

@pengtdyd 微信只接过支付 sdk 凑活着还能看= =

Kontinue

Kontinue      1 day ago

@bk201 商业版得都阿里云吧,支持私有部署吗?

Kontinue

Kontinue      1 day ago

@scxiazi 是的老外开源的东西要不就有文档,文档写的粗的一般 examples 也会详细写,rocket 这个文档文档不行,demodemo 不行……

Konys

Konys      1 day ago

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

CaptainD

CaptainD      1 day ago

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

seesky

seesky      1 day ago

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

uSy62nMkdH

uSy62nMkdH      1 day ago

我要吹一下 docker 的文档

Kontinue

Kontinue      1 day ago

@seesky 就是这个感觉啊

olaloongolaloong      23h 33m ago

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

zt52875287

zt52875287      23h 28m ago

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

twing37

twing37      23h 23m ago

#24 那我可要吹 rust 了

Kontinue

Kontinue      23h 2m ago

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

to2false

to2false      23h 0m ago

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

olaloong

olaloong      22h 48m ago

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

monetto

monetto      21h 35m ago   ❤️ 1

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

EarthChild

EarthChild      21h 30m ago

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

documentzhangx66

documentzhangx66      20h 11m ago

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

mikulch

mikulch      19h 45m ago via iPhone

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

kingfalse

kingfalse      18h 8m ago via Android

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

skiy

skiy      17h 28m ago

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

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

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

neoblackcap

neoblackcap      15h 41m ago

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

night98

night98      15h 4m ago

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

plko345

plko345      8h 26m ago via Android

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

sampeng

sampeng      8h 13m ago via iPhone

绝大部分选型是拍脑袋,一不看 issue 更新情况二不看代码发布频率不看文档不看 demo 丰富程度是基操了。看源码?那更不可能。反正就是跟风人云亦云…要换语言就是 java ,要用 java 就是 spring cloud 全家桶,都不带考虑只用 spring boot 的,要用全家桶就是 nacos 。因为用的人多所以没问题是很多人基本的逻辑自洽…但我其实完全理解这个决策流程…

Kontinue

Kontinue      7h 44m ago

@sampeng 那 nacos 和 sentinel 的文档比 rocket 写的好多了……

DinnyXu

DinnyXu      7h 17m ago

正儿八经的看过 RabbitMQ 的文档和实践过后,再去玩 RocketMQ ,那才真是差距大,开源的 RabbitMQ 的监控页面都比阿里开源的监控页面好看 100 倍...光是这点 rocket 就已经败了

tairan2006tairan2006      6h 41m ago

rocketMQ 我记得不是对标 kafka 的么,和 rabbitmq 不是一个使用场景吧…

Tinet

Tinet      5h 30m ago

rocketmq 感觉是有点随意,配置项都是用 brokerIP1,brokerIP2 这种命名的。。。

About Joyk


Aggregate valuable and interesting links.
Joyk means Joy of geeK