Skip to content

Latest commit

 

History

History
23 lines (14 loc) · 881 Bytes

File metadata and controls

23 lines (14 loc) · 881 Bytes

Engineering Style

이 문서는 세세한 포매팅 규칙이 아니라 오래 가는 엔지니어링 스타일만 적는다.

1. 복잡도는 경계에서 흡수한다

  • 화면에서 감당하기 어려운 복잡도는 Feature나 Client로 내린다.
  • 인증, 네트워크, 저장소 세부는 공통 경계에서 다룬다.

2. 이름보다 책임이 중요하다

  • 변수명 규칙보다 책임 분리가 더 중요하다.
  • 파일 하나가 너무 많은 이유를 설명해야 한다면 분리 신호로 본다.

3. 예시는 참고일 뿐 규칙이 아니다

  • 문서 속 코드 예시는 구조 설명용이다.
  • 실제 구현은 현재 코드 구조를 우선한다.

4. 문서는 적게, 대신 정확하게 유지한다

  • 쉽게 낡는 규칙은 문서화하지 않는다.
  • 남기는 문서는 팀이 계속 지킬 구조적 결정이어야 한다.