ソースコード中のコメントをドキュメントにするのは古くからJavaDocとかdoxygenみたいなのはあって、あれは良いものなんだけど、概要や設計思想がどこにも書いてないこと多いのだよなー。
メンテナンスに関しては、Rustのドキュメントコメント中のコードはテストが走る、ってのがとても良い仕組みだと思ってる
ソースコード中のコメントをドキュメントにするのは古くからJavaDocとかdoxygenみたいなのはあって、あれは良いものなんだけど、概要や設計思想がどこにも書いてないこと多いのだよなー。
メンテナンスに関しては、Rustのドキュメントコメント中のコードはテストが走る、ってのがとても良い仕組みだと思ってる
senooken JP Social is a social network, courtesy of senooken. It runs on GNU social, version 2.0.2-beta0, available under the GNU Affero General Public License.
All senooken JP Social content and data are available under the Creative Commons Attribution 3.0 license.