Skip to content

文档里MoonBit for Go Programmers的位置太靠前了 #1132

@anders-liu

Description

@anders-liu

文档里直接把“MoonBit for Go Programmers”放到Tutorial的第二部分,而且点击页底“Next”链接会直接跳入,仿佛有点“强制阅读”的感觉,对(我这样的)新手太容易混淆了。

这带来一个巨大的假设,就是MoonBit的新手都是学过go的。

我虽然了解过一些go语言,但完全称不上熟悉。在想学习MoonBit时,刚看完“A Tour of MoonBit for Beginners”就铺天盖地地来了一波与go语言的对比,在扫视文档里的代码块时,我不得不随时切换思路,识别看到的代码是go还是MoonBit……这对于学习MoonBit来说其实阻碍挺大的。这已经是我第三次尝试开始学习MoonBit了,前两次都是在“MoonBit for Go Programmers”读到一半就烦得不行而中断了。我一度以为MoonBit的文档就是全篇建立在“和go进行对比”的基础上的……

建议将“MoonBit for Go Programmers”放到整个文档靠后些的位置,在“A Tour of MoonBit for Beginners”的末尾留一个普通链接,熟悉go的朋友可以主动选择点击阅读。但文档底部的“Next”链接最好能直接跳转到“MoonBit Language”章节,让读者快速进入MoonBit,而不是直接两种语言对比着学一遍。

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions