Iloveski

Jira или аналоги используете? Если да, то номер задачи оттуда пишите обязательно. А так, лучше писать на более высоком уровне, объяснять зачем были сделаны изменения в коде, то есть, ближе вариант 2.