한글로 코딩하기

 

토스에서는 한글로 코딩을 하고 있다는 말을 듣고 찾아보게 되었는데 실제로 한글로 코딩을 진행하는 것 같았습니다. 한글로 코딩을 한다는 생각을 해보지 않았던 저로서는 한글로 코딩이 된다고??라는 사실이 더 충격이었던 것 같습니다. 

 

한글 코딩을 찾아보면서 장, 단점을 생각하게 되었는데 어떠한 것이든 장점과 단점이 존재하기 마련이지만 명확한 코딩 컨벤션이 정의되어 있는 상황에서 작업을 진행한다면 단점보다는 장점이 더 많을것 같다고 생각하였습니다. 

 

아래는 토스에서 정의한 세종대왕 프로젝트(한클 코딩 컨벤션) 입니다. 

한글 코딩에 관심이 있다면 한번쯤 가벼운 마음으로 읽어봐도 좋을 것 같습니다. 

 

세종대왕 프로젝트 (한글 코딩 컨벤션)

한글 코딩? 어려운 도메인 용어에 대해 변수명을 정할 때, 어색한 영어보다 이해하기 쉬운 한글로 짓는 컨벤션을 말합니다.보다 이해하기 쉽고 눈에 잘 들어오는 코드를 작성할 수 있다는 장점이 있습니다.

컨벤션이 왜 필요한가요?

한글 코딩을 한번도 해보지 않은 사람은 있어도 한번만 하는 사람은 없다.

여러 제품, 여러 프로젝트에서 사용되다보니 다양한 방식으로 사용되는데, 이에 대한 규칙(이하 컨벤션)이 없어서 의견이 엇갈리는 경우, 코드 리뷰에 자주 언급되어 정리하고자 합니다.

 

1. 범위

2. 방식

• 이해하기 쉽도록 작성하는 것을 제 1 원칙으로 한다.
• 영문/한글 혼용은 지양하며 단순 음차하는 방식이더라도 이해가 더 쉽다면 적용한다.
• 한글이라도 어려운 용어(고어, 한글로 대체 가능한 한자어) 사용은 배제한다.

3. 자세

• 어려운 도메인, 비즈니스 로직에서만 사용하자.
• 무분별한 한글 코딩은 지양하자.

4. 컨벤션

Boolean

• -인가

Space

• _로 구분

5. 예시

 

 

출처 :

• https://tosspayments-dev.oopy.io/chapters/frontend/posts/hangul-coding-convention
• https://dkmqflx.github.io/development/2021/07/18/refactoring-toss-cleancode/