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

读 rocketmq 文档有感

  •  3
     
  •   Kontinue · 111 天前 · 5084 次点击
    这是一个创建于 111 天前的主题,其中的信息可能已经有所发展或是发生改变。

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

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

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

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

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