basic/comment

[giscus[bot]]

basic/comment

https://course.rs/basic/comment.html

[bamboog]

/// 我怎么受不了这个文档注释，是我太菜么，看着就像一堆行代码注释

[mattwhatsup]

模块注释是对模块文件的注释，而不是对单个模块的注释，所以特别强调//!要在文件开头

说实在的rust这个oacjage crate module的概念有些矫情

文档中可以直接写测试用例倒是不错

[RaVincentHuang]

感觉跟doxygen的很像

[nasuf]

在综合例子中，既然使用了pub use进行重导出，那么在main.rs中在使用的时候就可以用下面这种方式了吧，不需要全路径：

use art::mix;
use art::PrimaryColor;

[Icemans007]

优秀学习了，没有你这个例子，我一直不明白为什么要在lib中使用 pub use，明明不用写也可以，作者案例没有写明白

[ghost]

这章好像没什么人，大家都不喜欢写注释是吧 😅

[dayou5168]

一个综合例子 这部分的src/lib.rs 直接复制内容是有问题，自动加了一些内容进粘贴板

[yichangliu695]

一个文档玩出花🌸来了，我受不了啊

[litingyes]

爽

[CrystalAnalyst]

Rust注释的花样也真多。。

[yhyzgn]

连注释都这么花哨~~

[kdurant]

功能太强大了
C++迟早歇菜

[J1nH4ng]

是在代码块```中使用# 开头的会被隐藏？

[yizhixiaowutu]

貌似是的，不然不就成了 markdown 语法的 标题 了嘛

[superjump22]

今后可能真的不需要写注释了，AI自动注释太牛了

[yizhixiaowutu]

Copilot yyds！

[AllenWu233]

Rust的文档功能太强大了

[everlose]

比 js 的 typedoc 和 jsdoc 强的太多了

[ShyunnY]

我一直对 lib.rs 和 main.rs 之间的关系很糊涂.

为啥在 lib.rs 中声明 mod, main.rs 使用是不需要用 mod <moduleName>; 导入？

lib.rs 作用是啥？

[17998384]

“文档测试(Doc Test)”这部分必须是库项目才能直接cargo test运行，我本地是个二进制项目跑了半天也不好使😒