moonbitlang / moon

The build system and package manager for MoonBit
https://moonbitlang.github.io/moon/
GNU Affero General Public License v3.0
140 stars 11 forks source link

docs(zh): update tutorial #257

Closed lijunchen closed 1 week ago

peter-jerry-ye-code-review[bot] commented 1 week ago

git diff 的输出中,我发现以下几个潜在的问题:

  1. 目录结构描述不一致

    • Understanding the Module Directory Structure 部分,描述中提到 source 字段指定了模块的源代码目录,默认值是 src。然而,在示例目录结构中,源代码文件却直接放在了 libmain 目录下,没有 src 目录。这可能会导致读者混淆,不确定源代码文件究竟是放在 src 目录下还是直接放在 libmain 目录下。
  2. 测试文件命名不一致

    • Stand-alone test files for blackbox tests 部分,提到以 _test.mbt 结尾的源文件被认为是黑盒测试的测试文件。然而,之前的 Creating and Using a New Package 部分中创建的测试文件名为 hello_test.mbt,但没有明确说明这个文件是用于黑盒测试的。这可能会导致读者不确定 hello_test.mbt 是否也适用于黑盒测试。
  3. 代码示例中的路径问题

    • Creating and Using a New Package 部分,创建新文件的过程中提到在 src/lib/fib 目录下创建文件。但是,在后续的代码示例中,路径引用仍然是 lib/fib 而不是 src/lib/fib。这可能会导致读者混淆,不确定路径应该如何正确引用。

以上是我观察到的三个潜在问题,希望能帮助你更好地改进文档。