경험을 통해 주니어 개발자와 취준생을 위한 Git 협업 스킬을 정리해봤어요. 😀

개발자로 시작하면서 처음 7년 동안은 혼자서 개발해왔어요.

그 시간을 보내며 항상 고민하던 생각은 "팀이 생기면, 내가 도움이 될까?"였어요.

(사실 이런 고민을 더 많이 했죠)

"이런 패턴은 정말 사용하는 패턴일까?"
"이 코드보다 좋은 코드는 있지 않을까? 어떻게 접근해야 그런 코드를 생각할 수 있을까?"
"이 코드는 진짜 사용하는 코드일까?"
"아... 사수 있었으면 좋겠다"

그래서 제가 처음 세운 목표는 "규칙을 잘 지키는 팀원되기"였어요. 팀 회식은 반드시 참여한다 뭐 이런 규칙은 아니고

팀의 코딩 *컨벤션이나 커밋 컨벤션과 같은 것들을 지키자에요.

(*컨벤션은 소프트웨어 개발 등에서 코드 작성이나 커밋 메시지 등에 적용되는 통일된 규칙이나 관례를 말해요)

어떤 팀을 만나게 될지 모르는데, 어떻게 지키냐고요?

저도 몰랐기 때문에 그냥 혼자서 시작해보기로 했어요.

혼자서 무엇을 하면 좋을지 고민하다가 생각의 범위를 좁혀보기로 했어요.

1번 2번을 넣었던 이유는 습관을 만들기 위해서였어요.
습관은 새로운 환경에서도 빠르게 적응할 수 있는 능력을 키워주니까요.

"간단하고 기계적인 것"을 고려했을 때, 이미 커밋 메세지 작성이 마음에 떠올랐어요. 3번 "팀 규칙으로 정해진 것"을 확인하기 위해 검색해보니, 이미 커밋 컨벤션이라는 키워드로 내용이 많이 있더군요.

몇가지 레퍼런스를 찾아놓고 시작했어요. 그런데 뭔가 따라하는 것 같아서 아주 간단하게 시작할 수 있게 제 마음대로 규칙을 정했어요.

아주 간단하죠?

하지만 이정도도 굉장히 만족했어요. 커밋 메세지를 맨 처음엔 이렇게 작성했거든요.

코드 일부 수정

혼자 개발하니까 눈치볼 필요가 없어서..🤷

아무튼 좋은 습관 만들기를 위해 고쳐 작성하기 시작해요.

Update 로그인 id 유효성 검사 로직 수정
...
Update 로그인 기능 버그 수정
Create 로그인 기능 추가

처음에는 굉장히 단순했는데, 점점 더 구체적으로 쓰는 정도가 됐었어요.

(6개월 정도 이 스타일로 작성했던 것 같아요.)

이쯤 되니 저런 형태의 커밋 메세지를 기계적으로 작성하기 시작했고, 좀 더 표준화된 커밋 컨벤션을 적용하고 싶다는 생각이 들었어요.

"커밋 컨벤션"을 검색해보면 다양한 규칙과 스타일이 나와요.

그 중에서도 재밌는거 하나랑 지금 사용중인거 하나를 소개해볼게요.

글 주제와는 거리가 있어서 간략하게 소개만 -

커밋 메시지에 이모지를 사용하여 변경 사항을 시각적으로 표현하는 방식이에요.

재미있고 신선함을 추구하신다면 한번 시도해보세요.

커밋 메시지를 일정한 규칙에 따라 작성하여 일관성을 유지하는 방식이에요. (현재 팀에서는 조금 축소한 버전으로 사용하고 있어요)

기본 형식:

<type>[optional scope]: <description>

[optional body]

[optional footer(s)]

각 요소는 다음을 의미해요:

예를 들어, 모든 요소를 반영한 커밋 메시지는 다음과 같이 작성할 수 있어요:

feat(web): 사용자 로그인 기능 추가

- 이메일과 비밀번호를 사용한 기본 로그인 기능 구현
- JWT를 사용하여 인증 세션 관리

Refs: #45

지금 사용하고 있는 패턴:

feat(foo-web-api): 회원가입 완료 이메일 템플릿 개선

- 이메일 제목 및 내용 개선
- foo-bar 푸터 추가
- foo-bar 안내 문구 추가
- 수신거부 링크 위치 변경

optional footer는 제외하고 optional body부분은 생략 하거나 축약 버전으로 작성해요.

대부분 Pull Request에 상세한 내용을 작성하고 있어요.

혼자서 개발하더라도 팀에서 지키는 규칙이나 관례를 미리 연습해 보는 것은 좋은 성장 방법 중 하나라고 생각해요.

커밋 컨벤션뿐만 아니라 코딩 컨벤션과 같이 코드 작성에 있어서도 일정한 규칙을 정해두면, 나중에 팀에서 협업할 때 큰 도움이 돼요.

이미 좋은 규칙들도 많이 있으니 따로 소개하진 않을게요.

처음에는 사소해 보일지 모르지만, 이러한 습관을 통해 자신만의 개발 철학이 생기고, 이는 곧 전문성으로 이어져요.

저는 팀원들이 코드나 커밋 메시지에 대해 왜 그렇게 작성했는지 질문할 것을 항상 상상했어요.

작은 것부터 시작해서 하나씩 개선해 나가면, 어느새 훨씬 능숙한 개발자가 되어 있을 거예요.

어려운 시기인데 모두 화이팅💪

[1편] 팀이 생기면, 내가 도움이 될까? - 혼자서도 지킬 수 있는 커밋 컨벤션