>>765
コードコメントをAPIドキュメントとして使うよう場合は
仕様としての処理の内容をコメントに書く

それに「この行は何をしたいのか」は基本的にコードに書くべきこと
特にPythonのように高レベル言語では意図が伝わるコードを書くべき