TIL (Today I Learned)

// 2022.02.28

오늘 읽은 범위

// 5장. 형식 맞추기

책에서 기억하고 싶은 내용을 써보세요.

1. 형식을 맞추는 목적

   • 돌아가는 코드가 개발자의 의무가 아니다.

   • 처음에 잡아놓은 스타일과 가독성의 수준은 이후의 코드에도 영향을 끼치며, 사라지지 않는다.

2. 신문 기사 처럼 작성하라

   • 이름은 간단하면서도 설명가능하게 지어라. 이름만 보고도 모듈을 살펴보고 있는지 아닌지를 판단할 정도로 신경 써서 짓는다.

   • 아래로 내려갈 수록 의도를 세세하게 묘사한다.

3. 수직 거리

   • 서로 밀접한 개념은 서로 가까이 둬야한다. 세로 거리가 가까울 수록 연관성이 높은것. 연관성이란 한 개념을 이해하는데 다른 개념이 중요한 정도를 나타낸다.

4. 변수 선언

   • 변수는 사용하는 위치에 최대한 가까이 선언한다.

5. 종속 함수

   • 호출하는 함수와 호출되는 관계의 함수가 있다면, 서로를 가까운곳에 위치 시킨다.

   • 호출하는 함수는 호출 되는 함수보다 앞에 둔다.

6. 개념적 유사성

   • 친화도가 높은 코드는 가까이 배치한다.

   • 친화도가 높은 코드란, 종속관계에 있는 함수 그리고 비슷한 동작을 수행하는 함수 등이 있다.

7. 세로 순서

   • 앞서 말했듯이 신문 기사와 마찬가지로 중요한 개념을 먼저 표현한다.

오늘 읽은 소감은? 떠오르는 생각을 가볍게 적어보세요

강하게 공감이 가기도, 반대로 거리감이 느껴지기도 하는 내용이 었다. 일을 하면서 팀단위로 개발을 시작하기 전에 용건 정의 이후 팀원 공통의 코딩룰 및 서식을 정했다. 정한 후에는 모두가 일정한 규칙에 따라서 정돈된 코딩을 적어 나갈 수 있었다. 하지만, 많은 작업수와 팀원수로읜해 이 규칙을 정하는데에 생각보다도 많은 시간이 걸려버렸다. 그리고 한가지 의문점이 었던것은 어떤것을 기준으로 규칙을 잡아야 하나 이었다. 팀원에는 분명히 사용하는 언어나 툴에 대한 이해도의 차이가 있다. 이해도가 높은 사람만을 기준으로 규칙을 짜버린다면 다른 팀원들이 이해하는데 고통을 느낄것이며, 기준을 낮게 잡으면 오히려 코드의 질이 떨어져버릴것이라고 느꼇다. 팀 리더나 매니져는 이에 유의하여 규칙을 정해야 할것이다.