是否可以在Rust中将源代码与文档注解分开?[已关闭]

ie3xauqp  于 2023-01-21  发布在  其他
关注(0)|答案(1)|浏览(96)

**已关闭。**此问题不符合Stack Overflow guidelines。当前不接受答案。

我们不允许问题寻求有关书籍、工具、软件库等的推荐。你可以编辑问题,以便可以使用事实和引用来回答问题。
5年前关闭。
Improve this question
我喜欢好的源代码文档,但我讨厌代码中的文档注解。我找到了将其他语言的代码与文档分离的解决方案,但不适用于Rust。那么,是否有将Rust中的源代码与文档分离的解决方案?

dgenwo3n

dgenwo3n1#

编辑:许多年过去了,下面的答案不再正确。请查看评论。

恐怕没有。我一直在关注Rust生态系统,但我从来没有看到过类似的东西。另外,我认为注解应该在代码中,如果你用Rust写开源代码,我建议你坚持标准的做事方式,只是为了其他人好。例如,我是制表符缩进而不是空格缩进的积极倡导者(“制表符缩进,空格对齐”),但由于Rust社区使用(明显低级:))空格,我在Rust项目中使用空格,这不符合我的喜好,但克服了它之后,它使我和其他人在合作时更轻松。
作为一个变通办法,我建议让你的编辑器积极地折叠评论。

相关问题