В идеале, каждый набор изменений должен содержать какое-то конкретное изменение, будь то что-то такое же маленькое, как исправление небольшой ошибки путем исправления одной строки в файле, или что-то такое же большое, как изменение сигнатуры функции по всей базе кода.
Это позволяет вам делать такие вещи, как пересадка набора изменений в другую ветвь позже, что легко сделать, только если ваши изменения не загрязнены несвязанными вещами.
(Кстати, в этом главное отличие современных DVCS, таких как Mercurial или Git, которые отслеживают изменения , и более старых систем, таких как SVN, которые отслеживают редакции .)
Если вам кажется, что вам нужно написать отдельные комментарии для каждого файла, это может означать, что вы фактически вносите несколько изменений, не связанных одновременно, что не является хорошей практикой.
С другой стороны, если это не так, вы, конечно, можете написать многострочное сообщение:
User can no longer add the same product twice (issue123)
add_product.py: added server-side validation
scripts.js: added client-side validation