[Java] 좋은 주석을 적는 방법

1. 코드 내용을 그대로 반복하는 (추가 정보가 없는) 주석은 적지 마라.
2. 좋은 주석은 불명확한 코드를 변명하지 않는다.
   1. 주석으로 코드를 설명하지 말고 코드를 다시 써라.
3. 명확한 주석을 적을 수 없다면 코드에 문제가 있을 수 있다.
   1. 코드가 어렵다고 주석으로 경고하지 말고 코드를 다시 써라.
4. 주석은 혼란을 야기하는 것이 아니라 해소해야 한다.
   1. 주석을 보고 더 헷갈린다면 그 주석은 지워라
5. 관용적이지 않은(undiomatic) 코드는 주석으로 설명하라.
   1. 불필요하거나 중복된다고 생각할 수 있는 코드, 이로 인해 다른 누군가가 "단순화"할 수도 있다고 생각되는 코드에는 주석을 달아 설명하는 것이 좋다.
6. 복사한 코드라면 원본 출처 링크를 주석에 포함하라
   1. 향후 코드를 읽을 동료가 전체 컨택스트(어떤 문제, 해당 솔루션이 권장되는 이유 등)를 파악하는데 도움이 될 수 있음.
7. 도움이 될만한 외부 참조 링크를 포함하라.
8. 코드를 수정할 때 특히 버그를 수정할 때 주석을 추가하라.
9. 주석을 사용해 불완전한 구현을 표시하라.
   1.  기술 부채를 측정하고 해결하는데 도움이 됨

 

 

 

 

 

 

 

 

 

출처

https://stackoverflow.blog/2021/12/23/best-practices-for-writing-code-comments/