Я работаю над проектом, в котором мы настроили систему управления исходным кодом, чтобы автоматически писать заметки в трекере ошибок. Мы просто пишем идентификатор ошибки в сообщении о коммите, и сообщение о коммите добавляется в качестве примечания к трекеру ошибок.
Я вижу только несколько недостатков этой практики. Если когда-нибудь в будущем исходный код будет отделен от программного обеспечения отслеживания ошибок (или сообщенные ошибки / проблемы будут каким-то образом потеряны). Или когда кто-то просматривает историю коммитов, но не имеет доступа к нашему трекеру ошибок.
Мой вопрос заключается в том, считается ли наличие сообщения об ошибке / проблеме в сообщении фиксации хорошей практикой? Есть ли другие недостатки?
Это очень распространенная практика, и я нашел ее очень удобной. Я использую TRAC, поэтому я могу прочитать историю кода и перейти к задаче, которая привела к изменению, или прочитать историю задачи и перейти к изменениям кода.
«Если когда-нибудь в будущем ...» Если вы отделите код от системы отслеживания ошибок, то старая история изменений, вероятно, не будет представлять дальнейшего интереса.
источник
Я тоже использую эту практику и считаю ее очень хорошей. Но помимо идентификатора проблемы, я добавляю краткое описание ошибки / функции (обычно это название системы отслеживания ошибок). Это часто помогает сэкономить время, потому что мне не нужно искать в системе отслеживания ошибок (потому что я распознаю изменение) И, как вы сказали, если я каким-то образом потеряю систему отслеживания ошибок, я не потеряюсь полностью.
источник