일단 주석도 문서임
코드보다 문서를 보는게 빠른 경우만 문서를 만들어야함
api를 만드는 경우에는 입력과 출력 예외등에 관한 명세가 주석에서 생성되는게 가장좃다능
주석이 코드의 업데이트를 반영하지못하면 코드리뷰에서 반드시 잡아져야함
그래서 주석은 리뷰하고 유지보수할 코드의 양이 늘어나는거랑 같으니까 불필요한 주석은 코드리뷰에서 지적이 되어야함
todo는 꼭 이슈티켓링크가 있어야함
안그러면 영원히 안한다능
코드보다 문서를 보는게 빠른 경우만 문서를 만들어야함
api를 만드는 경우에는 입력과 출력 예외등에 관한 명세가 주석에서 생성되는게 가장좃다능
주석이 코드의 업데이트를 반영하지못하면 코드리뷰에서 반드시 잡아져야함
그래서 주석은 리뷰하고 유지보수할 코드의 양이 늘어나는거랑 같으니까 불필요한 주석은 코드리뷰에서 지적이 되어야함
todo는 꼭 이슈티켓링크가 있어야함
안그러면 영원히 안한다능
- dc official App
그래서니가무슨말을하고싶은거냐 - dc App
(동의)