Community

개발자 99% 커뮤니티에서 수다 떨어요!

← Go back
#5 형식 정하기
#clean_code
2년 전
639

TIL (Today I Learned)

2022.02.28

오늘 읽은 범위

5장 형식맞추기

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

  • 코드가 오래되고 사라져도 변하지 않는 것은 맨 처음 잡아놓은 구현 스타일과 가독성 수준이다.

  • How To?

    • 적절한 행 길이 유지하기

      • 평균 파일 크기 65줄

    • 신문 기사처럼 작성하기

      • 최상단에는 전체를 요약하는 표제

      • 첫문단에는 전체 기사내용을 요약. 큰 그림 보여주기

      • 첫부분은 고차원적 개념과 알고리즘 설명

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

      • 마지막에는 저차원 함수와 세부내역

    • 개념은 빈 행으로 분리하기

      • 줄바꿈으로 행 묶음을 표현한다.

    • 세로 밀집도

      • 서로 밀접한 코드행은 세로로 가까이 놓는다.

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

      • 최대한 사용하는 언어, 프레임워크에 공감이 형성된 상식적인 위치에 놓을 것

    • 가장 중요한 개념을 가장 먼저 표현하기

      • 호출하는 함수를 먼저 배치한다.

    • 행은 짧은 것이 바람직하다

    • 팀 규칙 정하기

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

  • 요즘 팀으로 일하면서 공통의 규칙을 정하는 것이 필요하다고 생각하고 있었다.

  • 업무를 시작하기 전에 꼭 규칙을 협의해서 정하는 것이 좋은 것 같다. 그동안은 책의 내용에 나오는 것처럼 각자의 스타일 대로 작성해서 필요 이상으로 복잡하게 만들곤 했다.

  • 이번에 팀을 새롭게 빌딩하고 있는데

    이번 장을 통해 팀 규칙 가이드를 도입 할 수 있을 것 같다.