우리는 "저자" 입니다. | 클린코드 챌린지 (03 / 21)

/// <summary>
/// Nomad Coder - 클린코드 챌린지 - 03 / 21
/// @author         : CloudD
/// @last update  : 2025. 06. 19.
/// @update
///     - 2025. 05. 25 : 최초 작성. (2장. 의미 있는 이름)
///     - 2025. 06. 19 : 제목 수정. 형식 정리.
/// </summary>


Chat GPT 가 생성한 '개발자의 독서' 이미지 #2


오늘은 2장 "의미 있는 이름" 을 읽었습니다.
책에서 나열한 몇 가지 규칙들을 읽으면서 제게 도움이 될 만한 문장들을 발췌해 보았습니다.


이 책에서 소개하는 몇 가지 규칙

  1. 의도를 분명히 밝혀라.
  2. 그릇된 정보를 피하라.
  3. 의미 있게 구분하라.
  4. 발음하기 쉬운 이름을 사용하라.
  5. 검색하기 쉬운 이름을 사용하라.
  6. 인코딩을 피하라.
  7. 자신의 기억력을 자랑하지 마라.
  8. 클래스 이름과 객체 이름은 명사나 명사구가 적합하다.
  9. 메서드 이름은 동사나 동사구가 적합하다.
  10. 기발한 이름을 피하라.
  11. 한 개념에 한 단어를 사용하라.
  12. 말장난을 하지 마라.
  13. 해법 영역에서 가져온 이름을 사용하라.
  14. 문제 영역에서 가져온 이름을 사용하라.
  15. 의미 있는 맥락을 추가하라.
  16. 불필요한 맥락을 없애라.

기억하고 싶은 문장들

  • 의도가 분명한 이름이 정말로 중요하다.
  • 의도를 분명하고 솔직하게 표현하라.
  • 일관성 있는 어휘는 코드를 사용할 프로그래머가 반갑게 여길 선물이다.

소감

1장을 읽으면서 기억하고 싶었던 문장들 중 하나였던,
“우리는 저자다.”
를 다시 한번 생각하게 해주는 규칙들이었습니다.

글을 쓸 때 작성자는 명확한 의도를 가지고 글을 적어야 합니다.
하지만 때로는 하고 싶은 말이 많아져서 이것저것 쓰다 보면,
의미를 알 수 없는 글이 되어버리곤 합니다.

코드도 마찬가지라고 생각합니다.
의미없는 텍스트의 나열이 되지 않도록,
조금 더 신경 써서 코드를 정리해야겠습니다.


이 책을 왜 읽고 있을까?

이 책을 처음 구매하게 된 것은,
다른 개발자들로부터 들은 입소문 때문이었습니다.
하지만 지금 다시 이 책을 꺼내 든 이유는,
지금보다 더 좋은 코드를 남기고 싶은 마음 때문입니다.


CloudD

예술하는 프로그래머, 코딩하는 예술가

댓글 쓰기

다음 이전