tidy first 14장 '설명하는 주석' 을 읽고

주석의 예상 독자

컴퓨터 과학자로 구성된 팀 내 단 한 명의 생물학자라면 어떨까요?

그렇다면 당연해 보이는 내용이더라도 코드를 생물학적 맥락으로 설명하는 것이 좋습니다.

요점은 다른 사람의 관점에서 생각하고 예상되는 질문을 선제적으로 언급하려고 노력하는 것입니다.

다른 사람의 관점에서 생각하고 예상하는 질문을 선제적으로 언급 해야 한다는 말에 깊이 공감하지만, 한편으로 켄트 벡은 주석의 예상 독자를 매우 광범위하게 설정하고 있다고 느꼈습니다. 실무에서 주석의 예상 독자는 동료 개발자로 한정하는 것이 보다 현실적이라고 생각 했습니다.

 

테스트 코드의 display name

테스트 코드의 diaplay name 을 설명하는 주석의 한 형태로 볼 수 있다고 생각 했습니다. 코드를 직접 작성하지 않는 사람에게도 서비스에 대한 유용한 정보를 제공할 수 있기 때문입니다.

 

선언적 주석을 사용한 프로그래밍

GitHub Copilot이나 Cursor IDE 같은 도구들을 보았을 때, 주석만으로 의도를 표현하고 AI가 그에 맞는 코드를 생성하는 방식의 개발이 현실화 될 수 있겠다고 생각 했습니다. 선언적 프로그래밍 방식은 ‘어떻게 해야 하는지’ 가 아닌 ‘무엇을 해야 하는지’ 결과에 중점을 둔 패러다임 입니다. 주석을 어떻게 작성 하느냐에 따라 AI 가 작성해주는 코드가 달라지겠지만, 선언적으로 작성 된 주석 만으로도 애플리케이션 개발이 가능하겠다고 생각 했습니다.