클린코드 68 ~ 75 도입 잘 달린 주석은 어떤 정보보다 유용함. 반대로 경솔하고 근거없는 주석은 코드를 이해하기 어렵게 만든다. 또한, 주석은 “순수하게 선하지” 못하며, 기껏해야 필요악 정도이다. 코드에 비해 주석은 오래될수록 유지보수하기 어려움 ⇒ 오류 발생 ⇒ 최대한 사용 자제 주석보다는 코드를 깔끔하고 이해하기 좋게 만드는 것이 최우선 과제 주석은 나쁜 코드를 보완하지 못한다. 코드에 주석을 추가하는 일반적인 이뉴는 코드 품질이 나쁘기 때문 표현력이 풍부하고 깔끔하며 주석이 거의 없는 코드
이전자료 [Clean Code] - 3장 함수(1) 도입 프로그래밍 초창기 시스템은 루틴, 하위 루틴으로 나누어짐. 포트란, PL/1 시절에는 시스템을 프로그램, 하위 프로그램, 함수로 나눔. 지금은 함수만 남아있으며 어떤 프로그램이든 가장 기 leapday.tistory.com 방법 7) 부수 효과를 일으키지 마라! 때때로 함수를 통해 클래스 변수를 수정한다. 떄로는 함수로 넘어온 인수나 시스템 전역 변수를 수정한다. 이러한 경우들은 시간적인 결합(Temporal Coupling)이나 순서 종속성(Order Dependency)을 초래한다. boolean checkPassword(String userName, String password){ ... //if userName and password are..
도입 프로그래밍 초창기 시스템은 루틴, 하위 루틴으로 나누어짐. 포트란, PL/1 시절에는 시스템을 프로그램, 하위 프로그램, 함수로 나눔. 지금은 함수만 남아있으며 어떤 프로그램이든 가장 기본적인 단위가 함수이다. 이 장에서는 함수를 잘 만드는법을 소개함. 방법 1) 작게 만들어라! 함수를 만드는 첫째 규칙은 “작게!”이다. 그리고 두번쨰 규칙 또한 “작게!”이다. 함수는 작은 것이 좋다고 근거를 댈 수는 없지만, 작가의 오랜경험을 바탕으로 나온 조언이다. 그렇다면 얼마나 짧아야 좋은걸까?? 작가의 기준 = 블록과 들여쓰기 if 문/else 문/while 문 등에 들어가는 블록은 한 줄이어야 한다. 대개 거기서 함수를 호출하기에 바깥을 감싸는 함수(enclosing function)가 작아지며, 블록 ..
