Hacker News 의견

• GitHub 공동 창립자의 의견:

  • Git 커밋 메시지는 코드 문서화를 위한 독특한 방법이지만 최적화되지 않음.
  • 대부분의 도구는 커밋 메시지의 첫 줄만 보여줌.
  • Git은 이메일 본문처럼 모든 프로젝트 참여자가 읽을 수 있도록 커밋 메시지를 설계했으나, 현실에서는 거의 볼 수 없음.
  • git blame을 사용하여 관련 커밋 메시지를 찾는 것도 어려움.
  • Git 프로젝트의 커밋 메시지는 매우 상세하지만, 실제로는 거의 활용되지 않음.
  • Git을 통한 훌륭한 문서 작성은 대부분의 커뮤니티에서 시간 낭비에 가까움.

• 특정 문제에 대한 커밋 메시지의 중요성:

  • 문제를 명확하게 설명하는 커밋 메시지의 첫 줄이 중요함.
  • 필요한 경우 추가 정보를 제공하는 나머지 부분을 읽을 수 있음.

• 커밋 메시지에 대한 개인적인 감정:

  • 훌륭한 커밋 메시지를 작성하는 것에 대한 자부심이 있지만, 다른 사람들에게 가치가 있는지 확신이 없음.
  • 대부분의 사람들은 커밋 메시지를 거의 검색하지 않음.
  • 아름다운 커밋 메시지는 프로그래머의 허영일 수 있으며 실질적인 가치가 없을 수 있음.

• 커밋 메시지의 첫 줄 작성 전략:

  • git log를 사용할 때 첫 줄이 가장 중요함.
  • 첫 줄에는 무엇을 했는지가 아니라 왜 했는지를 명시해야 함.
  • 뉴스 기사처럼 중요도가 높은 정보부터 상세한 정보까지 순차적으로 작성하는 것이 좋음.

• 커밋 메시지 수정의 어려움:

  • 커밋 메시지는 작성 후 수정하기 어려움.
  • .md 파일이나 위키, Confluence 등의 문서는 수정이 용이함.
  • 컴포넌트의 설계를 설명하려는 유혹을 피하고, 필요한 경우 문서를 개선하는 것이 좋음.

• 작은 커밋에 대한 상세한 설명의 중요성:

  • 작은 커밋일수록 상대적으로 긴 설명이 필요할 수 있음.
  • 작은 변경 사항에 대한 이유를 상세히 설명하는 것이 중요함.

• 커밋 메시지의 한계와 도구의 문제점:

  • 커밋 메시지의 첫 줄을 더 구체적으로 작성할 필요가 있음.
  • 나머지 긴 설명은 큰 가치가 없을 수 있음.
  • 개발 도구의 문제점을 지적하며, 오류 메시지가 더 명확해야 함.
  • 코드 편집 도구가 비표준 공백 문자를 허용하는 이유에 대한 의문 제기.

• 커밋 메시지보다 커밋 위생의 중요성:

  • 커밋 메시지의 상세함보다는 좋은 커밋 위생이 더 중요함.
  • 깔끔하고 독립적인 커밋은 코드 기능을 쉽게 추출하고 재사용할 수 있게 함.

• 자동 스쿼시와 리베이스에 대한 비판:

  • 자동 스쿼시는 의미 있는 커밋 메시지 작성을 방해함.
  • 리베이스는 개발자가 의도적으로 정리하기 위한 것이지, 병합 시 기본 패턴이 되어서는 안 됨.