コメントに使い方とかいろいろ書くのはとても大切です ただ、あとから使い方が変わると非常にめんどくさいことになりますので 追加したい引数は今のうちに追加して、その使い方も書いてしまって、（現在未実装)…みたいな感じにしておくといいかもしれません そうすれば実際にその機能を追加したあとでも、それを呼び出してるプログラムの方はいじらずに済みますし