Rustのドキュメントコメントとソースコードを分けることはできますか？

Question

私はソースコードのための良いドキュメントが好きですが、私はコード内のドキュメンテーションのコメントが嫌いです。私は、コードを他の言語のドキュメントから分離するソリューションを見つけましたが、Rustでは解決しませんでした。ですから、ソースコードとRustのドキュメントを分離するためのソリューションはありますか？

Answer 1

私は恐れがあります。私はRustの生態系に従っています。私はそういったことについて一度も言及していません。関連するノートでは、コメントはコード内にあるべきだと思うし、Rustにオープンソースコードを書いていれば、他の人々のために、標準的なやり方を忠実に忠実にすることをお勧めします。例えば。私はスペースとは対照的に、タブのインデントを鮮明に主張しています（「タブでインデントし、スペースに合わせて」）。しかし、Rustコミュニティは（明らかに劣って:)スペースに定住しているので、私はRustプロジェクトでスペースを使用します。それは私の好みに合っていませんが、それを乗り越えた後は、私と他の人たちが協力するときに楽になります。

回避策として、私は編集者に積極的にコメントを表示させることをお勧めします。