성태의 닷넷 이야기
홈 주인
모아 놓은 자료
프로그래밍
질문/답변
사용자 관리
사용자
메뉴
아티클
외부 아티클
유용한 코드
온라인 기능
MathJax 입력기
최근 덧글
[정성태] Roll A Lisp In C - Reading ; https...
[정성태] Java - How to use the Foreign Funct...
[정성태] 제가 큰 실수를 했군요. ^^; Delegate를 통한 Bein...
[정성태] Working with Rust Libraries from C#...
[정성태] Detecting blocking calls using asyn...
[정성태] 아쉽게도, 커뮤니티는 아니고 개인 블로그입니다. ^^
[정성태] 질문이 잘 이해가 안 됩니다. 우선, 해당 소스코드에서 ILis...
[양승조
] var대신 dinamic으로 선언해서 해결은 했습니다. 맞는 해...
[양승조
] 또 막혔습니다. ㅠㅠ var list = props[i].Ge...
[양승조
] 아. 감사합니다. 어제는 안됐던것 같은데....정신을 차려야겠네...
글쓰기
제목
이름
암호
전자우편
HTML
홈페이지
유형
닷넷
.NET 3.0
.NET 3.5
.NET 4.0
VC++
개발 환경 구성
제품 소개
VS.NET IDE
Vista
Windows 7
Windows 8
Windows 서버
Team Foundation Server
IIS
디버깅 기술
Win32
64비트
오피스
웹
기타
Phone
부모글 보이기/감추기
내용
Can Code Be Truly Self-Documenting? ; https://docs.microsoft.com/en-us/archive/blogs/steverowe/can-code-be-truly-self-documenting 예전에 읽었던 실용주의 프로그래머인가 하는 책에서도 비슷한 이야기가 나왔었던 것이 기억납니다. 제 생각은... 그래도 주석이 필요하다는 의견입니다. 심지어, 코드 변경이 주석의 변경까지 수반하지 않았다고 해도, 그것 역시 주석의 한 기능이라고 볼 수 있습니다. 가끔... 이런 경우가 있지요! 도대체 "왜" 이렇게 만들었을까? 제작자의 "의도"가 무엇이었을까? 이런 코드로 만들어지기까지의 상황이 도대체 무엇인가? 등등. 따라서, 주석이 현재의 코드를 설명해 주진 않는다고 해도 과거의 그 코드 상황을 설명해 줄 것이고, 그리고 그것이 이렇게 변경된 것에 대한 힌트가 될 수도 있는 것입니다. 물론, 약간의 혼란을 줄수도 있는 것이 사실이지만... 하지만 그럼으로써 해당 코드의 철학을 더 잘 이해할 수 있게 됩니다. 좀 더 현실적인 의견을 제시하자면. 도구에 의해서 문서화까지 연결될 수 있는 "메서드 단위"의 주석은 필요하다고 봅니다. 물론, 이것도 절대적인 것은 아니고. 해당 메서드 내의 코드양이 얼마 되지 않는 경우에는 메서드 이름 자체를 주석으로 여기는 것이 좋겠습니다. 물론, 코드의 양이 많다면 전체적인 목적을 설명하는 주석은 꼭 달고. 주석을 다는 시점도 중요합니다. 적절한 체계가 갖춰진 조직이라면, 1주일에 한 번 정도는 작업량 할당 중에서 그 순간까지 만들었던 코드에 대해 주석을 달 수 있는 시간을 줘야 합니다. 그 시점이 refactoring 단계 다음이면 더욱 좋겠지요. 아니면 적절한 기능 구현 단계마다 이뤄지는 것도 좋겠고. ... 상황에 따라 매우 유동적일 수 있으니, 그 "순간"은 해당 팀 내에서 적절한 의견을 거치는 것이 좋겠습니다. 상황에 따라 적절히 달라질 수 있다는 점에 주의하셔야 합니다. 예를 들어 형상관리 툴로서 Team Foundation Server를 이용한다면 Work Item에 따른 코드들의 check-in 연결이 가능하기 때문에 Work Item에 부가된 설명 자체가 적절한 주석의 역할을 할 수도 있습니다. 안타까운 것은 이런 경우 문서화 도구를 통해서 표현되지는 않는다는 점이 있지만. 어쨌든 TFS에 엮어진 Annotate 기능이라면 해당 코드들에 대해서 연결된 Work Item의 설명을 바로 참조할 수 있기 때문에 적어도 "High Level Comments"의 하나로서 대접받을 수 있겠습니다. 어쨌든, 이런 문제는 Little Endian / Big Endian과 같이 논쟁의 연속이겠지만. ^^;
첨부파일
스팸 방지용 인증 번호
4502
(왼쪽의 숫자를 입력해야 합니다.)