What Does It Mean and Why Should I Bother? Motivating Students to Write Better Commit Messages

Abstract

This paper reports on a locally motivated mixed-methods case study addressing a teaching-related suspicion held by software engineering instructors: that commit messages written by students frequently fail to serve their intended communicative role. To examine this suspicion empirically, we analyzed commit messages from student and industrial case-study projects using a partial replication of an established commit-message quality taxonomy. The results confirm that communication and quality issues occur recurrently in both contexts, substantiating the instructors'initial concern. Motivated by this finding, we devised What Do You Mean? (WDYM), a lightweight, role-based educational game intended to surface and address commit-message communication breakdowns within the constraints of university coursework. Analysis of gameplay observations and participant surveys shows that WDYM is effective in raising awareness and fostering reflection on commit-message communication issues, although it provides limited evidence of immediate or sustained improvement in commit-message writing practices. Taken together, the study presents WDYM as a useful, though imperfect, context-bound intervention for addressing a locally observed instructional problem, without claiming general applicability beyond the studied setting.