Pythonにおける関数のコメント

関数が何をするのかを説明するコメントが必要な場合は、 関数本体の最初の行に記述するべきです：

pythondef func(num1, num2):
  '''2つの数値を加算する関数'''
  return num1 + num2

pythondef func(num1, num2):
  return num1 * num2