반응형

생각공부 2

좋은 주석, 나쁜 주석_CleanCode_70p

하지만 명심하기 바란다. 정말로 좋은 주석은, 주석을 달지 않을 방법을 찾아낸 주석이라는 사실을! _cleancode 70p 중 주석 챕터에 들어오면서 처음 개발 공부하면서 빌드했던 개념들이 와르르 무너지게 되었다. 주석을 사용하면 마냥 좋은 줄 알고 남발했던 모든 주석이 사실은 가독성을 해치며 코드를 읽는 이로 하여금 오해하게 만드는 주석이었다니.. 🍎 좋은 주석 책에서 소개하는 좋은 주석의 사레는 법적인 주석, 정보를 제공하는 주석, 의도를 설명하는 주석, 의미를 명료하게 밝히는 주석, 결과를 경고하는 주석, TODO 주석, 중요성을 강조하는 주석 등이 있다. 책에서는 이런 좋은 주석들도 가능하면 함수 이름이나 클래스를 만드는 등 코딩적인 방법을 이용해서 주석을 사용하지 않을 수 있으면 더 좋다고 얘..

book diary 2023.06.28

플래그 인수_CleanCode_52p

플래그 인수는 추하다. 함수로 부울 값을 넘기는 관례는 정말로 끔찍하다. 왜냐고? 함수가 한꺼번에 여러 가지를 처리한다고 대놓고 공표하는 셈이니까! 플래그가 참이면 이걸 하고 거짓이면 저걸 한다는 말이니까! -cleancode 52p 중 아니 정말로? 개발하면서 종종 option 같은 느낌으로 boolean 값을 인자로 받아서 쓰는 경우가 있었는데,, 정말로 끔찍하다는 표현을 마주하니 속으로 뜨끔했다. 조건에 따른 로직을 서로 다른 함수로 만들기엔 코드 길이가 길어지거나, 일부 중복된 코드가 있고 boolean 값에 따라 추가 로직이 있는 경우를 그렇게 사용했는데 책에서 하는 말처럼 여러 가지를 한다고 대놓고 공표하는 셈이었다. 생각해 보면 boolean의 경우뿐 아니라 enum 값과 같이 인자가 A o..

book diary 2023.06.23
반응형