V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
Kontinue
V2EX  ›  程序员

读 rocketmq 文档有感

  •  3
     
  •   Kontinue · 2022-03-10 10:46:37 +08:00 · 6706 次点击
    这是一个创建于 996 天前的主题,其中的信息可能已经有所发展或是发生改变。

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

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

    第 1 条附言  ·  2022-03-10 13:25:09 +08:00
    主要后端八股文落在 rocketmq 和 kafla 上,base 杭州
    45 条回复    2022-03-11 11:12:33 +08:00
    Vegetable
        1
    Vegetable  
       2022-03-10 10:50:31 +08:00
    某些开源项目确实是这样的。我曾经也有过同样的感叹。
    对 Java 生态的感触也最深。某些很流行的开源库,文档不行,代码注释也不行。遇到不清楚的点只能研读代码。
    上一个令我产生这种感叹的是 mybatis-plus
    Jekins
        2
    Jekins  
       2022-03-10 10:53:22 +08:00
    学 redis 的时候不看博客根本不行..官方没有 springboot 版本的文档. spring data 关于配置的寥寥几笔带过..完全不知道怎么配置.最后还是要翻博客...
    Kontinue
        3
    Kontinue  
    OP
       2022-03-10 10:59:16 +08:00
    @Jekins redis 资料还是很多的,我吐槽的点在于国人的开源,官方中文的文档,却不如别人的博客……
    hun2008hun
        4
    hun2008hun  
       2022-03-10 11:20:01 +08:00
    同感,rocketmq 文档真的是一言难尽
    miscnote
        5
    miscnote  
       2022-03-10 11:22:03 +08:00
    rabbitmq 的文档就很强。
    q474818917
        6
    q474818917  
       2022-03-10 11:23:37 +08:00
    一般人还是真不推荐用阿里开源的产品,生产遇到各种奇葩问题,简直就是小白鼠
    RichardYyf
        7
    RichardYyf  
       2022-03-10 11:24:14 +08:00
    哈哈哈,RocketMQ 文档真的一言难尽,对比 Pulsar 、RabbitMQ
    nekoneko
        8
    nekoneko  
       2022-03-10 11:27:54 +08:00
    @Vegetable #1 mybatic plus 的文档真是一言难尽, 版本更新都不带更新文档的
    nekoneko
        9
    nekoneko  
       2022-03-10 11:30:45 +08:00
    国内文档建设真的差好多
    bk201
        10
    bk201  
       2022-03-10 11:37:57 +08:00
    可能文档写的太细的话,没法推自己的商业版
    scxiazi
        11
    scxiazi  
       2022-03-10 11:39:39 +08:00   ❤️ 1
    除了吹自己性能好, 写几个 demo,剩下得啥也不写
    timepast
        12
    timepast  
       2022-03-10 11:47:19 +08:00
    公司有个项目,用到 BladeX ,项目开源,但文档收费
    ciki
        13
    ciki  
       2022-03-10 12:01:59 +08:00
    rocketmq 可是有商用版本的,开源版本可想而知了
    pengtdyd
        14
    pengtdyd  
       2022-03-10 12:44:25 +08:00   ❤️ 1
    和我用一个头像 真是英雄所见略同啊
    bigbyto
        15
    bigbyto  
       2022-03-10 12:49:26 +08:00   ❤️ 1
    我一直没搞懂为什么选型的时候会选 rocketmq ,做决策的人是完整看过它的代码,了解它的架构吗?这玩意从开源到现在几年了,文档基本上一点变化都没有,怎么敢用这种东西在生产环境的。
    pengtdyd
        16
    pengtdyd  
       2022-03-10 12:58:21 +08:00   ❤️ 4
    说阿里文档垃圾的人,大概率是没有看过微信的文档,这是我目前见过的最垃圾的文档
    Kontinue
        17
    Kontinue  
    OP
       2022-03-10 13:15:47 +08:00
    @bigbyto 嗷,我现在在面向面试学习中……但其实消息量不大,用啥都一样吧
    Kontinue
        18
    Kontinue  
    OP
       2022-03-10 13:18:51 +08:00
    @pengtdyd 微信只接过支付 sdk 凑活着还能看= =
    Kontinue
        19
    Kontinue  
    OP
       2022-03-10 13:21:10 +08:00
    @bk201 商业版得都阿里云吧,支持私有部署吗?
    Kontinue
        20
    Kontinue  
    OP
       2022-03-10 13:22:44 +08:00
    @scxiazi 是的老外开源的东西要不就有文档,文档写的粗的一般 examples 也会详细写,rocket 这个文档文档不行,demodemo 不行……
    Konys
        21
    Konys  
       2022-03-10 13:31:28 +08:00
    阿里的文档我觉得比微信还强点,微信的更是一言难尽
    CaptainD
        22
    CaptainD  
       2022-03-10 13:42:52 +08:00
    读阿里云的文档我以为我在读文言文
    seesky
        23
    seesky  
       2022-03-10 14:00:04 +08:00
    感觉有些文档美其名曰简洁凝练,结果就导致一种奇怪的情况,不会的人看不懂,看的懂的人本身就已经会了。
    uSy62nMkdH
        24
    uSy62nMkdH  
       2022-03-10 15:08:00 +08:00
    我要吹一下 docker 的文档
    Kontinue
        25
    Kontinue  
    OP
       2022-03-10 16:04:42 +08:00
    @seesky 就是这个感觉啊
    olaloong
        26
    olaloong  
       2022-03-10 17:09:32 +08:00
    阿里开源基本操作,fastjson 也是,文档注释要啥没啥
    慎用阿里开源
    zt5b79527
        27
    zt5b79527  
       2022-03-10 17:13:35 +08:00
    确实,真要提高,还是得读源码,博客什么的都是别人的东西。
    真要变成自己的东西,还是得读源码,写博客 /笔记。
    twing37
        28
    twing37  
       2022-03-10 17:18:43 +08:00
    #24 那我可要吹 rust 了
    Kontinue
        29
    Kontinue  
    OP
       2022-03-10 17:40:04 +08:00
    @olaloong 那 fastjson 倒是不用文档哈哈哈,直接用……
    to2false
        30
    to2false  
       2022-03-10 17:42:21 +08:00
    大概率因为文档不在 kpi 范围内
    olaloong
        31
    olaloong  
       2022-03-10 17:54:32 +08:00
    @Kontinue 常用 api 确实很香,但是但凡用到点高级功能,比如 @JSONType ,就炸了。18 年就挂着的 bug issue 到现在还没修呢
    注解属性文档也没有,代码里也没注释,要么看名字猜,要么看源码吧
    monetto
        32
    monetto  
       2022-03-10 19:07:10 +08:00   ❤️ 1
    FastJson Fast 倒是没多 Fast ,一堆 Issue...
    EarthChild
        33
    EarthChild  
       2022-03-10 19:11:35 +08:00
    所以。很多 MQ 教程大佬都推荐 RabbitMQ
    documentzhangx66
        34
    documentzhangx66  
       2022-03-10 20:31:09 +08:00
    从学习效率与作用的角度来看,去读代码,不如去学习,去自己做原型设计。
    mikulch
        35
    mikulch  
       2022-03-10 20:57:29 +08:00 via iPhone
    @Vegetable 看下 fastjson 你会觉得 mbp 文档真棒!
    kingfalse
        36
    kingfalse  
       2022-03-10 22:34:20 +08:00 via Android
    国产,哪有文档这玩意存在,
    skiy
        37
    skiy  
       2022-03-10 23:14:30 +08:00
    其实文档详细的还是有的,比如 thinkphp 。

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

    说实在的,老外开源的项目(知名项目),源代码里面的注释非常多(方法前面几大段几大段的注释)。关于开源治理这块,我们差了很多。比如 Rust 开发团队都分 文档团队、仓库团队、核心团队什么的。。。
    neoblackcap
        38
    neoblackcap  
       2022-03-11 01:01:11 +08:00
    文档本来是有的,好像爆出过,开源之前要把文档干掉
    night98
        39
    night98  
       2022-03-11 01:37:36 +08:00
    rocketmq 包括对应的 java sdk ,阅读源码问题也挺多的,基本上没注释,还得根据上下文推测,其他稍微用心做的开源都没这毛病,比如 hutool
    plko345
        40
    plko345  
       2022-03-11 08:16:07 +08:00 via Android
    公司里选型的时候,非常痛恨那些选阿里的,没有一个好用的,噩梦
    sampeng
        41
    sampeng  
       2022-03-11 08:29:07 +08:00 via iPhone
    绝大部分选型是拍脑袋,一不看 issue 更新情况二不看代码发布频率不看文档不看 demo 丰富程度是基操了。看源码?那更不可能。反正就是跟风人云亦云…要换语言就是 java ,要用 java 就是 spring cloud 全家桶,都不带考虑只用 spring boot 的,要用全家桶就是 nacos 。因为用的人多所以没问题是很多人基本的逻辑自洽…但我其实完全理解这个决策流程…
    Kontinue
        42
    Kontinue  
    OP
       2022-03-11 08:58:12 +08:00
    @sampeng 那 nacos 和 sentinel 的文档比 rocket 写的好多了……
    DinnyXu
        43
    DinnyXu  
       2022-03-11 09:25:10 +08:00
    正儿八经的看过 RabbitMQ 的文档和实践过后,再去玩 RocketMQ ,那才真是差距大,开源的 RabbitMQ 的监控页面都比阿里开源的监控页面好看 100 倍...光是这点 rocket 就已经败了
    tairan2006
        44
    tairan2006  
       2022-03-11 10:01:31 +08:00
    rocketMQ 我记得不是对标 kafka 的么,和 rabbitmq 不是一个使用场景吧…
    Tinet
        45
    Tinet  
       2022-03-11 11:12:33 +08:00
    rocketmq 感觉是有点随意,配置项都是用 brokerIP1,brokerIP2 这种命名的。。。
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   1713 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 27ms · UTC 16:39 · PVG 00:39 · LAX 08:39 · JFK 11:39
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.