コメントを英語で書くときに注意するべきこと

API ドキュメント作成ガイドライン | Rails ガイド」がすごくいい

API ドキュメント作成ガイドライン | Rails ガイド

Rails/Ruby以外にも通用すると思う。

すごく参考になった。