주석 적냐 마냐에 대한 짧은 생각
https://okky.kr/articles/1391785#note-1620894
이쪽글이 주석글로 댓글 맛집이 되서 새로 스레드 판다는 의미로 글 남겨 봅니다.
제 개인적 의견이겠지만 주석이 필요없다는 얘기는 절대 아닙니다.
스파게티나 이상한 함수명이나 반대로 깨끗한 함수는 주석이 필요없다는 얘기도 절대 아니구요
협업을 하는 이상 어느정도 선에서의 콘센서스가 맞다면 굳이 세세한곳에까지 시간과 노력을 넣지는 말자는 기조입니다.
반대로 외부에 sdk 나 라이브러리로 공개하는 코드라면 비교적 많은 부분에 주석을 넣어주는게 바람직하죠
초면으로 보는 사람이 많으니까요
글들 보면서도 생각해보면 협업을 많은 사람들이 하고 서로간의 커뮤니케이션이 적다면
아무래도 주석도 넣어주고 함수명 파라미터도 알기 쉽게 넣어주는게 서로 좋을거 같네요
하지만 혼자서 그렇게 해봐야 모난돌일뿐이고
어느정도 규모를 가지고 진행해야 좋은 피드백도 받고 효과도 있을거라 생각합니다.
아무데나 가서 이건 본질적으로 안되 라고 꽉막힌 사고가 결국 많은 부분에서 병폐를 낳는다고 생각하네요