Yes, but not in the form of commit messages, the parent comment described things better suited to jira tickets, documentation etc.

It feels like we're trying really hard to stretch the utility of commit messages here...

▲

cratermoon 14 minutes ago | parent | next [-]

You'll at least need the discipline to include the ticket ID in the message. Links to documentation are ok, but they will likely rot and even if they don't the content may change such that it no longer accurately reflects the commit changes.

▲

macintux 2 hours ago | parent | prev [-]

Mainly I was pushing back on: the code is the "truth"

I don't feel that is an accurate statement for any complex system.

▲

PUSH_AX 2 hours ago | parent [-]

I don't like complex systems, and I work hard not to create them.

	▲	mgfist 2 hours ago \| parent [-]
		Sure but code can't capture everything. Maybe with enough comments I guess, but not code alone. For example, code won't tell you that this feature was timeboxed hence this edgecase was not supported